Agent skill · writing content · aiskillstore
skill-writer
Guide users through creating Agent Skills for Claude Code. Use when the user wants to create, write, author, or design a new Skill, or needs help with SKILL.md files, frontmatter, or skill structure.
Why this skill is useful
Provides a structured approach to creating Agent Skills with specific YAML frontmatter requirements and best practices that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Skill Writer This Skill helps you create well-structured Agent Skills for Claude Code that follow best practices and validation requirements. When to use this Skill Use this Skill when: Creating a new Agent Skill Writing or updating SKILL.md files Designing skill structure and frontmatter Troubleshooting skill discovery issues Converting existing prompts or workflows into Skills Instructions Step 1: Determine Skill scope First, understand what the Skill should do: 1. Ask clarifying questions: What specific capability should this Skill provide? When should Claude use this Skill? What tools or resources does it need? Is this for personal use or team sharing? 2. Keep it focused: One Skill = one capability Good: "PDF form filling", "Excel data analysis" Too broad: "Document processing", "Data tools" Step 2: Choose Skill location Determine where to create the Skill: Personal Skills (~/.claude/skills/): Individual workflows and preferences Experimental Skills Personal productivity tools Project Skills (.claude/skills/): Team workflows and conventions Project-specific expertise Shared utilities (committed to git) Step 3: Create Skill structure Create the directory and files: For multi-file Skills: Step 4: Write SKILL.md frontmatter Create YAML frontmatter with required fields: Field requirements: name: Lowercase letters, numbers, hyphens only Max 64 characters Must match directory name Good: pdf-processor, git-commit-helper Bad: PDFProcessor, Git Commits! description: Max 1024 characters Include BOTH what it does AND when to use it Use specific trigger words users would say Mention file types, operations, and context Optional frontmatter fields: allowed-tools: Restrict tool access (comma-separated list) Use for: Read-only Skills Security-sensitive workflows Limited-scope operations Step 5: Write effective descriptions The description is critical for Claude to discover your Skill. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/skill-writer