Menu
Meta-skill: how to write a SKILL.md that the OctoCode skills hub will pick up. Source of truth for the descriptor schema.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when: applying Matt Pocock engineering skills for diagnosis, TDD, architecture improvement, issue breakdown, PRD creation, or rigorous TypeScript/codebase analysis.
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
Use when: working with OpenAI Codex plugins, plugin marketplaces, plugin manifests, plugin-bundled skills, or the openai/plugins repository. Helps inspect .codex-plugin/plugin.json, .agents/plugins/marketplace.json, and installed Codex plugin cache.
| name | agent-skills |
| description | Meta-skill: how to write a SKILL.md that the OctoCode skills hub will pick up. Source of truth for the descriptor schema. |
Canonical template and discovery rules for OctoCode skills.
| Field | Required | Meaning |
|---|---|---|
name | yes | Stable identifier; lowercase-with-dashes. Must match dir name. |
description | yes | One-sentence purpose. Shown in skills-list output. |
integration | yes | One of: internal / external-library / external-binary / external-agent / reference-only. |
source | if external | Upstream URL. Audit trail for provenance. |
status | recommended | documented / descriptor-only / stable / experimental. |
octocode_skills::SkillRegistry::discover(workspace_root, user_config_home) walks:
<workspace>/skills/*/SKILL.md<user_config_home>/octocode/skills/*/SKILL.mdWorkspace skills shadow user skills of the same name.
skills/<name>/SKILL.md with the frontmatter above. No registration step needed.skills-list reflects on next run (no cache).tools-hub — the aggregate view.find-skill — discovery helper.