<!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->
# FAOS Skills for OpenAI Codex

> Exported on 2026-03-13 | 520 skills

## Overview

This directory contains FAOS custom skills exported for use in OpenAI Codex.
Each skill is a self-contained directory with a `SKILL.md` file and optional supporting files (references, examples, assets, scripts).

## Skills by Domain

| Domain | Count |
|--------|-------|
| cloud | 99 |
| ai-research | 85 |
| business | 46 |
| devops | 46 |
| security | 41 |
| ai-ml | 30 |
| tools | 30 |
| documentation | 25 |
| backend | 23 |
| frontend | 22 |
| testing | 21 |
| architecture | 19 |
| data | 19 |
| integrations | 14 |

## Installation

### Option 1: Repository Skills (Recommended)
1. Copy skill folders into `.agents/skills/` at your repo root
2. Codex discovers them automatically at startup
3. Skills trigger based on `description` field matching

### Option 2: Personal Skills
1. Copy skill folders into `~/.codex/skills/`
2. Available across all your Codex sessions

### Option 3: Symlink from Canonical Location
```bash
# If you also use Claude Code, symlink to serve both:
ln -s /path/to/export/codex/.agents/skills/ .agents/skills
ln -s /path/to/export/codex/.agents/skills/ .claude/skills
```

## Important Notes

- Codex frontmatter supports ONLY `name` and `description` (no `tags`)
- Additional metadata is in `agents/openai.yaml` per skill
- `AGENTS.md` at repo root serves as project instructions (like `CLAUDE.md`)
- Codex also reads `CLAUDE.md` as fallback (configurable in `~/.codex/config.toml`)
- Skills with multi-agent instructions have been annotated with platform notes

## Source

These skills are exported from the [FAOS Agent Framework](https://github.com/frank-luongt/Foundation-AgenticOS)
using `scripts/export-skills.py`. The source of truth is `.faos/custom/skills/`.
