Menu
Extract a known field from a YAML file by running yq instead of reading the whole file.
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
Record a durable engineering decision in the repo's append-only decision log (docs/decisions.md by default). Use after choosing between real alternatives — a dependency, a version pin, an architecture or protocol choice, a deliberate non-implementation, or a reversal of an earlier decision. Also use when the user says "log that decision", "write this down", or asks what was decided and why.
Structural code search and refactoring via ast-grep. Reach for this when Edit fails with "old_string not unique", when refactoring across formatting variations, or when matching code shape rather than text.
Outline a file or package (functions, classes, methods, types, imports, exports) instead of reading it whole. Use before opening an unfamiliar or large file to orient, when surveying a package's API surface, or to find where a symbol is defined so you can Read just that range -- any "what's in / list / show me the structure of" need. Not for "where is X used" (search) or "how does X work" (read the body).
How to author Claude Code plugins (agents, skills, commands, hooks, MCP servers) and distribute them via a marketplace. Use when creating, structuring, or revising a plugin, deciding which skill pattern fits, or writing SKILL.md / agent / hook / manifest files.
Implement TODO.md items via isolated subagents, then adversarially verify correctness. Drives a phased loop that implements one checkbox at a time, runs independent lint/test/review subagents, handles human verification, and commits per subsection.
Create and maintain structured TODO.md implementation plans with phased tasks, testing philosophy, and verification checklists. This skill should be used when the user asks to create a TODO file, implementation plan, project roadmap, or phased development plan. Also use when asked to update or extend an existing TODO.md in this style.
| name | yq |
| description | Extract a known field from a YAML file by running yq instead of reading the whole file. |
When you need a specific field from a YAML file, reach for yq rather than Read. Syntax mirrors jq.
yq '.field' file.yml
Assumes mikefarah/yq (Go-based). The Python kislyuk/yq fork has different syntax; if jq-style queries don't work, check which yq is on PATH.
Three things easy to forget:
-r -- raw string output (no surrounding quotes)select(document_index == N) -- pick the Nth doc in a multi-document file (--- separators)yq -o json file.yml | jq '...' -- escape hatch when yq syntax gets uglyFor anything else, yq --help.