Menu
Meta-skill: how to write a SKILL.md that the OctoCode skills hub will pick up. Source of truth for the descriptor schema.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
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.