A shareable collection of reusable AI-agent skills. Each skill is a self-contained folder with instructions and optional scripts, references, and assets.
| Skill | Purpose |
|---|---|
ears-requirements |
Create gated, Kiro-compatible requirements, design, and task artifacts using EARS acceptance criteria. |
bugfix-specs |
Create gated, Kiro-compatible bugfix analysis, root-cause design, and task artifacts for surgical bug fixes. |
execute-spec-tasks |
Execute and track implementation work from a confirmed Kiro-compatible specification. |
ai-skills/
├── <skill-name>/
│ ├── SKILL.md # Required: metadata and agent instructions
│ ├── agents/
│ │ └── openai.yaml # Recommended: Codex UI metadata
│ ├── scripts/ # Optional: executable helpers
│ ├── references/ # Optional: supporting knowledge
│ └── assets/ # Optional: templates and output resources
├── CONTRIBUTING.md
├── LICENSE
└── README.md
Only SKILL.md is required in a skill folder. Keep user-facing repository documentation at the
repository root rather than duplicating it inside each skill.
Clone the repository:
git clone https://github.com/jlsc01/ai-skills.git
cd ai-skillsCopy the skills you want into your Codex skills directory:
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ears-requirements bugfix-specs execute-spec-tasks "${CODEX_HOME:-$HOME/.codex}/skills/"For local development, symlink them so edits are available immediately:
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s "$PWD/ears-requirements" "${CODEX_HOME:-$HOME/.codex}/skills/ears-requirements"
ln -s "$PWD/bugfix-specs" "${CODEX_HOME:-$HOME/.codex}/skills/bugfix-specs"
ln -s "$PWD/execute-spec-tasks" "${CODEX_HOME:-$HOME/.codex}/skills/execute-spec-tasks"Restart the agent or begin a new session after installation. Invoke a skill by name, for example:
Use $ears-requirements to create a specification for passwordless sign-in.
Other agents that support the open SKILL.md folder convention can use the same skill folders;
follow that agent's documentation for its discovery directory.
- Create a lowercase, hyphenated directory at the repository root.
- Add a
SKILL.mdcontaining onlynameanddescriptionin its YAML frontmatter. - Write concise, imperative instructions for the agent.
- Add
scripts/,references/, orassets/only when the skill needs them. - Add
agents/openai.yamlwhen the skill should expose Codex display metadata. - Test the skill on a realistic prompt and update the table above.
Minimal example:
---
name: example-skill
description: Perform a specific workflow. Use when the user asks to ...
---
# Example Skill
Follow these instructions ...See CONTRIBUTING.md for the review checklist.
Available under the MIT License. Individual assets or third-party materials must retain any applicable notices.