2.4 KiB

Raw Permalink Blame History

Skills

Reusable skill documents for AI coding agents working on this repository. Each skill is a self-contained SKILL.md that teaches an agent how to perform a specific task.

Available Skills

Skill	Description
`bug-triage/`	Triage bugs reported in chat/issues — investigate, search duplicates, file GitHub issues, push fix PRs
`agent-orchestrator/`	Architecture and conventions for working on the agent-orchestrator codebase
`release-notes/`	Generate weekly release notes from git history
`social-media/`	Social media post generation

How to Use

Copy the skill into your coding agent's skill directory. The destination depends on which agent you're using:

Claude Code

cp -r skills/bug-triage .claude/skills/bug-triage

Or add the full path to your CLAUDE.md:

See skills/bug-triage/SKILL.md for bug triage workflow.

OpenAI Codex CLI

cp -r skills/bug-triage .codex/skills/bug-triage

Or reference in AGENTS.md:

See skills/bug-triage/SKILL.md for bug triage workflow.

Cursor

Add to .cursor/rules/ as a rule file:

cp skills/bug-triage/SKILL.md .cursor/rules/bug-triage.mdc

Windsurf / Other Codeium-based agents

Add to .windsurf/rules/:

cp skills/bug-triage/SKILL.md .windsurf/rules/bug-triage.md

GitHub Copilot

Add to .github/copilot-instructions.md or reference in .github/:

cp skills/bug-triage/SKILL.md .github/skills/bug-triage.md

Gemini CLI

cp -r skills/bug-triage .gemini/skills/bug-triage

Agent Orchestrator (this project)

Skills in this skills/ directory are automatically available to agents spawned via ao spawn. Reference them in AGENTS.md or CLAUDE.md so agents load them at the start of a session.

Writing a New Skill

Create a directory under skills/<name>/
Add a SKILL.md with YAML frontmatter:

---
name: my-skill
description: One-line description of what the skill does.
trigger: When to activate this skill.
---

Write the skill body in markdown — numbered steps, code blocks, tables
Keep it agent-agnostic: use gh CLI, git, and standard Unix tools. Avoid tying to a specific agent framework
Reference it in AGENTS.md so spawned agents discover it

2.4 KiB Raw Permalink Blame History