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

> Exported on 2026-03-13 | 520 skills

## Overview

This directory contains FAOS custom skills exported for use in GitHub Copilot.
Each skill is an `.instructions.md` file in the `instructions/` subdirectory.

## 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: Copy to Project (Recommended)
1. Copy the `instructions/` directory into `.github/instructions/` at your project root
2. Copilot auto-discovers all `.instructions.md` files
3. Each file's `applyTo` frontmatter controls when it activates

```bash
# Copy all FAOS skills to your project
cp export/copilot/instructions/faos-skill-*.instructions.md .github/instructions/

# Or selectively copy specific skills
cp export/copilot/instructions/faos-skill-dev-story.instructions.md .github/instructions/
```

### Option 2: Organization-Wide
1. Add instructions to your `.github` repository for org-wide availability
2. All repos in your org will have access to the skills

### Option 3: Cherry-Pick
1. Browse the `instructions/` directory for skills relevant to your workflow
2. Copy individual `.instructions.md` files to `.github/instructions/`

## Important Notes

- Each skill is a `.instructions.md` file with `applyTo` YAML frontmatter
- `applyTo: '**/*'` means the skill applies to all files (default)
- Copilot also supports `.github/copilot-instructions.md` for project-wide instructions
- Skills with multi-agent instructions have been annotated with platform notes
- Agent personas are available separately in `.github/agents/*.agent.md`

## 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/`.
