create-skill

Scaffolds personal, project, or plugin skill directories with required SKILL.md frontmatter.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/lsongdev/skills --skill create-skill-lsongdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/lsongdev/skills/tree/main/create-skill
Command: npx skills add https://github.com/lsongdev/skills --skill create-skill-lsongdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a new agent skill requires knowing the correct directory locations, mandatory YAML frontmatter, and plugin marketplace configuration, which is easy to get wrong and causes skills to fail loading. ## Core Features & Use Cases - Skill Type Clarification: Guides users to choose between personal (~/.adal/skills/), project (.adal/skills/), or public plugin (GitHub repo) skills. - Structure Scaffolding: Creates the skill directory and a SKILL.md file with the required name and description YAML frontmatter. - Plugin Marketplace Setup: Generates .claude-plugin/marketplace.json with owner, metadata, and skills array configuration for Claude Code compatibility. - Use Case: A team lead wants to codify API conventions as a shared skill; the skill walks them through creating .adal/skills/api-conventions/SKILL.md and committing it to git. ## Quick Start Ask the agent to create a new skill and answer its prompts about skill type, name, and trigger scenarios.

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 custom agent skill?▼

Decide the skill type first: personal skills go in ~/.adal/skills/, project skills in .adal/skills/, and public plugins in a GitHub repo. Then create a SKILL.md file with YAML frontmatter containing at least name and description fields.

What is the difference between personal, project, and plugin skills?▼

Personal skills live in ~/.adal/skills/ and are only visible to you. Project skills live in .adal/skills/ and are shared with your team via git. Plugin skills are published as GitHub repositories for public community use.

Why is my skill not loading or appearing in the skills list?▼

Skills fail to load when SKILL.md lacks the required YAML frontmatter block with name and description fields. For plugin skills, also verify the skill path is listed in the skills array of marketplace.json.

Where should marketplace.json be placed for a Claude Code plugin?▼

The marketplace.json file must be placed in the .claude-plugin/ directory at the repository root. It requires an owner object with name and email, a metadata wrapper with description and version, and a plugins array listing skill paths.

How do I install a skill plugin from GitHub?▼

Add the marketplace with /plugin marketplace add owner/repo, then install with /plugin install plugin-name@marketplace-name. The marketplace-name comes from the name field in marketplace.json, not the repository name.