Generate numbered repo spec folders with clear requirements, implementation plans, and task lists for non-trivial project work.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Spec Writer Skill
## Intent
Use this skill to turn a rough repo change, feature idea, cleanup effort, or migration into a numbered spec folder with practical planning documents. The goal is to create a working spec package that another engineer can pick up and execute without guessing what the work means.
## Use When
- The user wants a new spec for a repo change, feature, refactor, migration, or workflow
- A project needs structured `requirements.md`, `plan.md`, and `tasks.md` documents
- The repo already uses numbered spec folders and new work should follow that pattern
- The request is large enough that ad hoc notes would be too loose
## Do Not Use When
- The change is tiny and does not need formal planning
- The repo has no spec workflow and the user only wants direct implementation
- The user wants a README, assessment, or changelog instead of an execution spec
- The available context is too thin to produce honest requirements and next steps
## Workflow
1. Read the repo context and Git status first; identify existing planning files and user edits.
…
The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_lj3yf2cafc4z5uj4
GET https://markdownregistry.com/api/v1/resolve?ref=mickpletcher/ai-skills/spec-writer
GET https://markdownregistry.com/api/v1/blob/362f9a1fa74786f9d93f561bd1da188e0600c4c711e7461ef5d58ab935f3f714
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
mickpletcher/ai-skills · claude/skills/alpaca-trading/SKILL.md · Work safely in the Trading repository for Alpaca helpers, backtesting, journaling, scheduling, and related PowerShell…
mickpletcher/ai-skills · claude/skills/blog-post/SKILL.md · Write or draft a blog post for Mick's IT blog at mickitblog.blogspot.com. Trigger when Mick asks for a blog post or…
mickpletcher/ai-skills · claude/skills/blog-to-social/SKILL.md · Convert a finished blog post into three ready-to-post social media versions in one pass for Facebook, X, and LinkedIn…
mickpletcher/ai-skills · claude/skills/container-home/SKILL.md · Answer questions, assist with planning, and help with design decisions for Mick's off-grid shipping container lake home…
mickpletcher/ai-skills · claude/skills/crypto-listings/SKILL.md · Retrieve new cryptocurrency listings from the past 7 days and upcoming listings in the next 7 days across major…
mickpletcher/ai-skills · claude/skills/crypto-research/SKILL.md · Deep-dive research report on a specific cryptocurrency before trading or investing. Always trigger immediately when the…
mickpletcher/ai-skills · claude/skills/facebook-post/SKILL.md · Write and polish Facebook posts on any topic. Trigger on requests to draft, rewrite, polish, improve a Facebook post…
mickpletcher/ai-skills · claude/skills/facebook-reply/SKILL.md · Write replies to Facebook comments on Mick's posts. Trigger on requests to reply to a Facebook comment, especially when…
mickpletcher/ai-skills · claude/skills/fitness-log/SKILL.md · Track workouts, log fitness progress, adjust the training program, and generate Facebook posts from workout data…
mickpletcher/ai-skills · claude/skills/fitness-programming/SKILL.md · Build structured training plans, progression blocks, and goal-specific fitness programming for Mick. Trigger when the…
jpeetz/agent-skills · skills/documentation-content/spec-writer/SKILL.md · Use this skill when a vague feature request, ticket, PRD fragment, or rough idea needs to be turned into a structured…
kambleakash0/agent-skills · skills/spec-writer/SKILL.md · Create a comprehensive Product Requirements Document from conversation and repo context. Use when the user wants a PRD…
dayvisonassis/sdd-skills · skills/spec-writer/SKILL.md · Generates technical implementation spec, plan, AND an operational contract for one or more features based on PRD…
