Skip to main content
affpapa.org
RU EN
skill

skill-creation-guide — Claude Code skill: purpose and setup

A guide to planning and updating Claude Code skills, from the required SKILL.md fields to optional scripts, references, and assets.

Install into Claude Code · claude-code-templates All methods and platforms ↓ 
npx claude-code-templates@latest --skill development/skill-creation-guide
Open on GitHub

What skill-creation-guide does

Use this skill when you are building a new skill or revising an existing one. It covers the required SKILL.md, its name and description metadata, and optional scripts/, references/, and assets/ directories. These parts let you organize procedures, domain guidance, and files used in generated output.

The guide recommends separating short core instructions from material Claude can load when needed. It also connects instruction detail to task risk: fragile procedures call for tighter steps, while work with several valid approaches can leave more room for judgement. That distinction matters when a skill shares context with the conversation.

Claude Code and an installed skill file are needed to use the guide. It offers design guidance rather than generating a finished skill on its own. Keep SKILL.md as the required entry point; add bundled resources only when they support the task.

What it helps with

  • plan the files and metadata for a new skill
  • write descriptions that help a skill trigger for the right task
  • move detailed reference material out of core instructions
  • choose between scripts and flexible text guidance
  • trim files that do not support the skill's task

Example prompts for the agent

  • Help me plan a Claude Code skill for PDF processing, including its metadata and file layout.
  • Review my SKILL.md and suggest which details belong in references/.
  • Decide whether this skill needs scripts or can rely on written instructions.

How to install skill-creation-guide

1claude-code-templates

npx claude-code-templates@latest --skill development/skill-creation-guide

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill skill-creation-guide -a claude-code

3Manually: put the files in place

~/.claude/skills/skill-creation-guide/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-creation-guide/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about skill-creation-guide

How do I install skill-creation-guide in Claude Code?

Run npx claude-code-templates@latest --skill development/skill-creation-guide. Another installation method is npx skills add davila7/claude-code-templates --skill skill-creation-guide -a claude-code.

What does skill-creation-guide do?

It guides the design and revision of skills, including their metadata, instruction detail, and optional bundled files.

Which fields are required in SKILL.md?

Its YAML frontmatter needs name and description, followed by Markdown instructions. Scripts, references, and output assets can be kept in optional directories.

Similar skills

SKILL.md skills catalog →
find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs frontend-design official anthropics This skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. 1,025,790installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. 1,163,035installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. CX Codex +1 678,700installs

From the same set495

The whole set →
tdd-gate The hook blocks edits to production files until a matching test exists. Useful if you want the agent to keep the TDD order. 192installs debug-window Opens a live-tailing debug log window when Claude starts with --debug or -d, then closes it when the session ends. 189installs semantic-kernel-dotnet A Claude subagent that writes and refactors .NET code for Semantic Kernel, checking the current Microsoft docs instead of trusting its own memory of the API. 189installs plan-writing Breaks work into short tasks, each with its own verification step. Useful for feature work, refactoring, or any multi-step job. 188installs microsoft-agent-framework-python A Claude subagent that writes and refactors Python code on Microsoft Agent Framework: agents, workflows, and migration from Semantic Kernel or AutoGen. 188installs initref Builds reference docs about how the project is implemented into a /ref directory and links them from CLAUDE.md. 186installs file-uploads A Claude skill that guides the agent through file uploads and cloud storage: S3, Cloudflare R2, presigned URLs, multipart transfers and image optimization. 185installs code-permutation-tester Runs several implementation approaches through simulation and scored quality gates so you pick one before writing the real code. 184installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor