{ "schema": "aiblocks-page/1", "id": "reusable-skill-requirements-planner-builder-prompt", "type": "prompt", "name": "Reusable skill build brief writer", "summary": "Fill in a short template and paste it into Claude Code. It writes a reusable skill file for any task you repeat, run with a slash command.", "headline": "Reusable skill build brief writer", "subhead": "Fill in a template with the skill's name, steps, what it needs, what it gives back and its rules. Paste it into Claude Code. It writes a skill file you can run again and again with a slash command, such as /weekly-review.", "job": { "id": "build-software", "name": "Build and ship software" }, "level": "intermediate", "thinking": "medium", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-25", "inputs": [ { "type": "codebase", "required": true, "label": "Codebase", "what": "a project's code, in a folder or repo the AI can open" } ], "outputs": [ { "type": "code_change", "required": true, "label": "Code change", "what": "a change to the code, with what it fixes and how it was checked" } ], "you_give": [ "The skill's name and the command you will type, such as /weekly-review", "What the skill does, step by step, in your own words", "What it needs from you each time, such as a spreadsheet, a client name or pasted text", "What the result should look like, such as a table with set columns or a numbered action list", "Rules it must always follow and things it must never do", "The tone it should write in (optional)" ], "you_get": [ "A skill file in your project at .claude/skills//SKILL.md", "A set layout: title and role, steps, scoring logic if you need it, output format, rules and how to handle unclear input", "Blanks you left empty marked MISSING, with a note on what to decide", "A short note on how to run the new skill and test it" ], "use_when": [ "You paste the same long instructions into your AI every week or every client.", "A teammate keeps doing a task differently and you want one saved way to do it.", "You have a checklist in your head, such as a pre-launch check, and want it to run on command.", "You know what the finished result should look like but not how to write a skill file." ], "skip_when": [ "You are in a chat AI and not in Claude Code, and want a draft from a job you repeat: use the Reusable AI skill writer.", "You already have a skill file and want it checked: use the AI skill file checker.", "You want to turn a whole book into skills: use the Book and document skill builder.", "The task happens once. Ask your AI directly. A skill only pays off when you repeat the work." ], "output_sample": { "input": [ "The skill's name and command", "The steps it should follow, in your words", "What it needs from you and what it should hand back", "Rules it always and never follows, and its tone (optional)" ], "prerequisites": [ "Claude Code installed and open in a folder" ], "output": [ { "name": "SKILL.md front matter", "contains": "The skill's name and a one-line description of what it does and when to use it." }, { "name": "Role and Process", "contains": "Who Claude acts as, and your steps in order." }, { "name": "Scoring or sorting logic", "contains": "The labels or scores your task needs and how each one is decided. Left out if not needed." }, { "name": "Output format", "contains": "The exact layout of the result, such as the table columns you asked for." }, { "name": "Rules", "contains": "What the skill always does and never does, in your words." }, { "name": "If something is unclear", "contains": "What to do when input is missing: ask once or mark MISSING, never guess." }, { "name": "How to run and test it", "contains": "The command to type, what to give it and what to check in the first three runs." } ] }, "output_shape": "FILE: .claude/skills//SKILL.md\n\n---\nname: \ndescription: \n---\n\n# \n## Role: \n## Process: \n## Scoring or sorting logic: \n## Output format: \n## Rules: \n## If something is unclear: \n\nHOW TO RUN: \nTO DECIDE: ", "how_to_use": [ "Open a folder in Claude Code. Claude Code runs on a paid Claude plan or an API account. Skills saved in a project folder work for that project.", "Copy the template from the skill file. Fill every [BRACKET] with your own details and delete the example lines.", "Paste it in. Claude Code may ask a question or two, then writes the skill file.", "Open the new file. Check that it starts with a name and a description, that the steps are in order and that it says what to do when input is missing.", "Type your command with a real input. Run it three times and check the layout stays the same.", "Tell Claude Code what to change, such as 'add a rule that it never guesses a number', and run it again." ], "checks": [], "next": [ { "name": "AI skill file checker", "url": "https://useaiblocks.com/prompts/skill-file-problem-spotter", "why": "AI skill file checker" } ], "source": null, "credits": [], "files": [ "references/worked-example.md" ], "links": { "page": "https://useaiblocks.com/prompts/reusable-skill-requirements-planner-builder-prompt", "markdown": "https://useaiblocks.com/prompts/reusable-skill-requirements-planner-builder-prompt.md", "json": "https://useaiblocks.com/prompts/reusable-skill-requirements-planner-builder-prompt.json", "instructions": "https://useaiblocks.com/skills/reusable-skill-requirements-planner-builder-prompt/SKILL.md", "download": "https://useaiblocks.com/skills/reusable-skill-requirements-planner-builder-prompt.zip", "api_item": "https://useaiblocks.com/api/v1/items/reusable-skill-requirements-planner-builder-prompt", "api_document": "https://useaiblocks.com/api/v1/documents/prompt/reusable-skill-requirements-planner-builder-prompt", "mcp": "https://useaiblocks.com/mcp" } }