create-skill

Creates or migrates SKILL.md files to the Claude Code skill standard.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill create-skill-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/create-skill
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill create-skill-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Writing a well-formed Claude Code skill requires knowing frontmatter fields, quality rules, and directory conventions, and teams often have existing prompts scattered across Cursor, Continue, Copilot, or legacy command files that need porting. ## Core Features & Use Cases - Create Mode: Interviews the user about purpose, triggers, side effects, tools, and scope, then writes a complete SKILL.md from a canonical template. - Migrate Mode: Reads an existing prompt file (.cursorrules, .mdc, .continue/prompts, copilot-instructions.md, legacy .claude/commands) and converts it into a standards-compliant skill. - Quality Enforcement: Applies rules for declarative bodies, dynamic context injection, allowed-tools scoping, and disable-model-invocation for side-effecting skills. - Use Case: You have a Cursor .mdc rule that reviews pull requests; run this skill in migrate mode to convert it into a project-level Claude Code skill with proper frontmatter and argument handling. ## Quick Start Ask the assistant to create a new skill named summarize-pr or to migrate the file at .cursor/rules/review.mdc into a Claude Code skill.

Frequently Asked Questions about create-skill

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

FAQPage Schema
How do I create a Claude Code skill from scratch?▼

Invoke the skill with a new skill name as the argument. It asks about purpose, trigger phrases, side effects, required tools, arguments, and scope, then writes a complete SKILL.md to ~/.claude/skills/ or .claude/skills/ using the canonical template.

How to migrate a Cursor rules file to a Claude Code skill?▼

Pass the path to the .cursorrules or .mdc file as the skill argument. The skill extracts the core intent, rewrites instructions declaratively, converts placeholders to arguments, and writes a standards-compliant SKILL.md.

What frontmatter fields does a Claude Code SKILL.md support?▼

Supported fields include description, when_to_use, argument-hint, arguments, disable-model-invocation, user-invocable, allowed-tools, context, agent, model, and effort. Only description is strongly recommended; others are optional based on the skill's behavior.

When should a skill set disable-model-invocation to true?▼

Set it whenever the skill writes files, commits, deploys, sends messages, or calls external APIs. This prevents the model from auto-invoking a skill with side effects without explicit user intent.

Can I convert GitHub Copilot instructions into a Claude skill?▼

Yes. The migrate mode recognizes .github/copilot-instructions.md and workspace YAML files, extracting intent and steps into a Claude Code SKILL.md while applying the quality rules for frontmatter and body structure.