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.