playbooks

home / skills / ratacat / claude-skills / create-agent-skill

create-agent-skill skill

/skills/create-agent-skill

This skill helps you create or edit Claude Code skills with expert guidance on structure and best practices.

npx playbooks add skill ratacat/claude-skills --skill create-agent-skill

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
282 B
---
name: create-agent-skill
description: Create or edit Claude Code skills with expert guidance on structure and best practices
---

## Arguments
skill description or requirements

## Allowed tools
- Skill(create-agent-skills)

Invoke the create-agent-skills skill for: $ARGUMENTS

Overview

This skill helps you create or edit Claude Code skills with expert guidance on structure, metadata, and best practices. It combines automated checks and human-readable recommendations to produce consistent, maintainable skill source. Use it to move from requirements or a draft to a polished skill implementation quickly.

How this skill works

Provide a skill description or requirements and the tool analyzes expected inputs, outputs, manifest fields, and supporting files. It synthesizes a recommended project layout, generates or updates code templates, and flags missing tests or metadata. The skill can call the create-agent-skills tool to perform automated scaffolding when you want output files created.

When to use it

  • Starting a new Claude Code skill from requirements or a product brief
  • Refactoring or standardizing an existing skill to follow best practices
  • Filling in missing metadata, manifest entries, or deployment configuration
  • Preparing a skill for review, testing, or publication
  • Generating skeleton code, tests, and documentation from a high-level description

Best practices

  • Write a clear one-sentence capability statement and concise example prompts
  • Keep handlers small and single-purpose; separate I/O, logic, and config
  • Include a manifest with required fields, versioning, and usable examples
  • Add unit and integration tests that assert intent handling and output shape
  • Document installation, usage, and troubleshooting in plain language

Example use cases

  • Convert a product requirements document into a working skill scaffold with handlers and manifest
  • Audit an existing skill for missing metadata, accessibility issues, or brittle logic
  • Generate example prompts and test cases to validate common user flows
  • Standardize multiple skills to a shared layout and CI test matrix
  • Produce a minimal deployable package that includes code, tests, and documentation

FAQ

What input format does the skill accept?

Provide a plain-text description or bulleted requirements; you can also supply partial code snippets or manifest fragments.

Can this skill modify files directly?

Yes—when authorized, it can invoke the create-agent-skills tool to scaffold or update files. Otherwise it returns a patchable plan and code snippets.