Brainstorm Skills

Goal

Identify useful Codex skills for the current repository and turn selected ideas into high-quality SKILL.md drafts.

Success means the suggested skills solve recurring work, do not duplicate existing skills, have clear trigger descriptions, and include the right project-local or global placement.

Stop when the user has a short ranked list of skill ideas or, if requested, validated skill files.

Workflow

1. Read the nearest AGENTS.md files for project rules, commands, and conventions.
2. Scan top-level project files such as flake.nix, package.json, Cargo.toml, pyproject.toml, Makefile, justfile, Dockerfile, and CI workflows.
3. Review existing project skills in .codex/skills/*/SKILL.md.
4. Review relevant global skills in config/codex/skills/*/SKILL.md when a proposed workflow may already exist globally.
5. Identify recurring pain points from scripts, tests, CI, docs, and config layout.
6. If the user names a focus area, prioritize that area while still checking for duplication.