# Create a Claude Code Skill

Creating a skill can be difficult when its files, metadata, and references are unclear. This guide explains a practical structure for authoring organized Claude Code skills.

## Install

```bash
npx skillstore add claudecode-npc/how-to-create-claude-code-skill
```

## Metadata

- Status: approved
- Slug: claudecode-npc-how-to-create-claude-code-skill
- Skillstore revision: r3
- Version status: missing
- Tree hash: a5fe0babc83f2e04f7db4db12caefad5c2c805cd44c6d330044eed6671bb8bb2
- Author: ClaudeCode-NPC
- GitHub username: ClaudeCode-NPC
- License: MIT
- Repository: https://github.com/ClaudeCode-NPC/Whispers-from-the-Star/tree/master/.claude/skills/create\_skill
- Ref: c68df504887c54bf71d2d467a1fbebde49467868
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 77
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/claudecode-npc-how-to-create-claude-code-skill
- Manifest: https://skillstore.pages.dev/api/skills/claudecode-npc-how-to-create-claude-code-skill/manifest

## Capabilities

- Explains the required SKILL.md file and YAML front matter.
- Shows basic and extended directory structures for skills.
- Describes personal and project-level skill locations.
- Illustrates references to supporting documentation and helper scripts.
- Lists documented size, metadata, and reference-depth guidance.

## Use Cases

- Start a personal skill: Set up a personal skill directory and create the required SKILL.md structure.
- Standardize project guidance: Organize project-specific skills with references, examples, and optional helper scripts.
- Plan a larger skill library: Use progressive disclosure and functional folders to keep several related skills maintainable.

## Prompt Templates

### Beginner: create a basic skill

```
Use this guide to help me create a basic Claude Code skill named Writing Documentation. Draft the SKILL.md metadata and sections.
```

### Intermediate: choose a location

```
Based on this guide, explain whether I should store my new skill in my personal Claude directory or in this project.
```

### Intermediate: add references

```
Help me organize a Claude Code skill with SKILL.md, reference.md, examples.md, and one helper script. Explain what belongs in each file.
```

### Advanced: design a skill collection

```
Design a maintainable folder structure for skills covering code review, documentation, PDF processing, and spreadsheet analysis. Use progressive disclosure.
```

## Limitations

- The guide is primarily written in Chinese.
- It provides guidance rather than creating files automatically.
- It does not validate a finished skill.
- It does not cover every Claude Code skill feature or tool integration.

## Best Practices

- Use a specific action-oriented name and a clear description.
- Keep primary instructions concise and place detailed material in referenced files.
- Store project-specific skills in the project directory so collaborators can use them.

## Anti Patterns

- Do not use vague names such as Helper or Tools.
- Do not put all reference material into SKILL.md when it can be loaded only when needed.
- Do not create deeply nested chains of reference files.

## Security Audit

- Audited at: 2026-07-18T10:31:40.742\+00:00
- Summary: All eight static detections are false positives in context. The file is an instructional guide: it includes a local directory creation example and official documentation links, but no executable payload, data collection, or prompt injection. No semantic security findings were identified.

## Stats

- Views: 262
- Downloads: 11
- Favorites: 0
- Popularity score: 0