{
  "markdown": "# My Skills\n\nLightweight engineering workflow skills for coding agents.\n\nDesigned for daily development with Codex, Claude Code, and Cursor. Not a heavy\nmethodology — just the important engineering gates:\n\n- clarify functional changes before implementation\n- write the right level of documentation\n- use domain language consistently\n- plan larger work before coding\n- implement behavior with TDD\n- diagnose bugs before patching\n- verify before claiming completion\n\n## Supported Agents\n\n| Agent | Status | Entry point |\n|---|---|---|\n| Codex | Supported | `.codex-plugin/plugin.json`, `scripts/install-codex-skills.sh` |\n| Claude Code | Supported | `.claude-plugin/plugin.json`, `hooks/` |\n| Cursor | Supported | `.cursor-plugin/plugin.json` |\n| Gemini | Compatibility | `GEMINI.md` |\n\n## Skills\n\n| Skill | When |\n|---|---|\n| [`grill`](skills/engineering/grill/SKILL.md) | New feature, behavior change, API/data change, domain terms unclear |\n| [`plan`](skills/engineering/plan/SKILL.md) | Sequencing approved work into steps and vertical slices |\n| [`tdd`](skills/engineering/tdd/SKILL.md) | Implementing behavior one red→green→refactor cycle at a time |\n| [`diagnose`](skills/engineering/diagnose/SKILL.md) | Bugs, errors, failures — reproduce first, fix second |\n| [`finish`](skills/engineering/finish/SKILL.md) | Verify diff + evidence, then commit/push/PR |\n| [`review`](skills/engineering/review/SKILL.md) | Handling code review feedback with verification |\n| [`architecture`](skills/engineering/architecture/SKILL.md) | Coupling, boundaries, test seams blocking current work |\n| [`subagents`](skills/engineering/subagents/SKILL.md) | Parallel delegation for large approved work |\n| [`prototype`](skills/engineering/prototype/SKILL.md) | Quick spike or PoC, skip full gates |\n| [`caveman`](skills/engineering/caveman/SKILL.md) | Terse communication, same gates |\n\n## How Triggering Works\n\nThree layers ensure skills activate:\n\n1. **SKILL.md `description`** — each skill has keywords (中英双语) that the\n   agent matches semantically against user intent\n2. **`skills/TRIGGERS.md`** — a compact intent→skill mapping table injected\n   via SessionStart hook\n3. **`CLAUDE.md` / `AGENTS.md`** — instructs the agent to read TRIGGERS.md\n   before any coding task\n\nNo dedicated router skill. The agent matches intent directly.\n\n## Default Flow\n\n```text\ngrill → user approves artifact → plan (if multi-step) → tdd → finish\n```\n\nBug flow:\n\n```text\ndiagnose → tdd (regression test) → finish\n```\n\nReview flow:\n\n```text\nreview → diagnose or tdd as needed → finish\n```\n\n## Documentation Levels\n\n| Level | File | When |\n|---|---|---|\n| 0 | none | Visual micro-change, typo, formatting |\n| 1 | `docs/agents/notes/YYYY-MM-DD-topic.md` | Single feature, single module |\n| 2 | `docs/agents/specs/YYYY-MM-DD-topic-design.md` | Multi-module, API, data flow |\n| 3 | Level 2 + `docs/agents/plans/YYYY-MM-DD-topic.md` | Needs sequencing |\n| ADR | `docs/adr/NNNN-title.md` | Hard to reverse, trade-off driven |\n| Domain | `CONTEXT.md` | Domain term or boundary resolved |\n\n## Install\n\n### Claude Code\n\n```bash\nclaude -p \"<prompt>\" --plugin-dir \"$PWD\"\n```\n\nThe `hooks/session-start` hook injects `TRIGGERS.md` at session start.\n\n### Codex\n\n```bash\nscripts/install-codex-skills.sh\n```\n\nPreview first: `scripts/install-codex-skills.sh --dry-run`\n\n### Cursor\n\nUses `.cursor-plugin/plugin.json` with `hooks/hooks-cursor.json`.\n\n## Contributing\n\nSkill changes are behavior changes, not prose edits. For functional changes:\n\n- write or update the relevant artifact under `docs/agents/`\n- keep `SKILL.md` files concise\n- update tests when routing behavior changes\n- run `tests/codex/validate-plugin-shape.sh`\n\nBefore opening a PR, show the complete diff and get explicit approval.\n",
  "bytes": 3748,
  "sha": "5f63d72fd0f02840937ca8fa851d0fd9a1f613771143866a638ffb6173aeb99c",
  "repo_slug": "oyzg/my-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_oyzg_my_skills_cca2cb0f/readme"
}