skill-writer

Create, write, and validate Agent Skills for Claude Code.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/maxwalser001-del/shieldpilot --skill skill-writer-maxwalser001-del
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/maxwalser001-del/shieldpilot/tree/main/.claude/skills/skill-writer
Command: npx skills add https://github.com/maxwalser001-del/shieldpilot --skill skill-writer-maxwalser001-del

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided, repeatable method to create, write, and validate Skill units for Claude Code. It helps ensure that each Skill folder contains a correctly named directory, a SKILL.md with proper frontmatter, and a clear executable workflow, reducing discovery and triggering issues.

Core Features & Use Cases

  • Generates a complete SKILL.md frontmatter and body that defines the skill's name, description, triggers, and usage.
  • Validates folder structure, ensuring the presence of a valid SKILL.md and any optional components (scripts/, references/, assets/) only when populated.
  • Provides a structured workflow with steps, examples, testing plans, and troubleshooting guidance to enable reliable activation and maintenance.
  • Advises on placement (personal vs project) to maximize portability and collaboration.

Quick Start

Create the skill folder named skill-writer in the correct location, place a complete SKILL.md with valid frontmatter, then restart Claude Code and test three trigger prompts.

Frequently Asked Questions about skill-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code skill folder with valid frontmatter?▼

To create a Claude Code skill folder, generate a correctly named directory containing a SKILL.md file with required frontmatter fields, a runnable body, and optional populated component subdirectories to ensure reliable activation.

What frontmatter fields are required for a SKILL.md file in Claude Code?▼

Required frontmatter fields for a SKILL.md file are name and description, which ensure proper discovery and triggering when Claude Code activates the skill folder during deployment.

How do I test and troubleshoot a new Agent Skill for Claude Code?▼

Test and troubleshoot a new Agent Skill by restarting Claude Code, validating the folder structure, and running three trigger prompts to verify reliable activation and correct frontmatter parsing.

When should I use optional scripts, references, or assets folders in a skill folder?▼

Include optional scripts, references, or assets folders in a skill folder only when they are populated, maintaining a clean directory structure and ensuring Claude Code processes them correctly.

Does skill placement matter for Claude Code portability and collaboration?▼

Skill placement matters for portability and collaboration, requiring correct directory selection between personal and project locations to maximize discovery and ensure reliable triggering across deployments.