技能 skill-development

🛠️

skill-development

Name: skill-development
Author: davila7

安全 ⚙️ 外部命令🌐 網路存取📁 檔案系統存取

Create and structure Claude Code plugin skills

Building effective AI skills requires understanding progressive disclosure and proper documentation structure. This skill teaches you how to create modular skills that load efficiently and trigger at the right time.

支援: Claude Codex Code(CC)

📊 71 充足

下載技能 ZIP

在 Claude 中上傳

前往設定 → 功能 → 技能 → 上傳技能

開啟並開始使用

測試它

正在使用「skill-development」。 Create a skill for editing PDFs

預期結果:

Skill structure: pdf-editor/SKILL.md with scripts/rotate_pdf.py
Trigger phrases: 'rotate PDF', 'edit PDF', 'merge PDFs'
Progressive disclosure: core workflows in SKILL.md, detailed API docs in references/

正在使用「skill-development」。 My skill description is vague

預期結果:

Before: 'Provides guidance for working with hooks'
After: 'This skill should be used when the user asks to create a hook, add a PreToolUse hook, or validate tool use'
Key fix: Added third-person format and specific trigger phrases

安全審計

安全

v5 • 1/17/2026

This skill is purely documentation providing guidance on creating skills for Claude Code plugins. All 241 static findings are FALSE POSITIVES caused by documentation examples and markdown code blocks showing directory structures, bash commands, and YAML frontmatter. No executable code, no network calls, no actual security risks exist.

已掃描檔案

1,036

分析行數

發現項

審計總數

風險因素

⚙️ 外部命令 (148)

🌐 網路存取 (2)

skill-report.json:156 skill-report.json:6

📁 檔案系統存取 (6)

SKILL.md:609 SKILL.md:610 SKILL.md:611 SKILL.md:612 SKILL.md:613 SKILL.md:614

審計者: claude 查看審計歷史 →

品質評分

架構

100

可維護性

內容

社群

100

安全

規範符合性

你能建構什麼

Create first plugin skill

Learn the complete workflow from understanding use cases to writing SKILL.md with proper structure and trigger phrases.

Improve existing skill

Apply progressive disclosure principles to move detailed content to references and keep SKILL.md lean and focused.

Write effective trigger descriptions

Learn to write third-person descriptions with specific user phrases that reliably activate skills.

試試這些提示

Start new skill

I want to create a skill for [domain]. Help me understand what concrete examples I should gather first.

Review skill structure

Review my skill and check if it follows the progressive disclosure principle. My SKILL.md is [X] words.

Fix trigger description

My skill description is '[current description]'. Rewrite it in third person with specific trigger phrases.

Refactor for disclosure

My SKILL.md is 5000 words. Help me identify what content should move to references/ to keep the body under 2000 words.

最佳實務

Keep SKILL.md body under 2000 words and move detailed content to references/ for efficient loading
Write frontmatter descriptions in third person with exact phrases users would say
Use imperative verb-first instructions instead of second person throughout the skill body

避免

Putting all documentation in SKILL.md without using references/ for detailed content
Writing vague descriptions like 'Provides help with X' without specific trigger phrases
Using second person 'You should...' instead of imperative 'Configure the...' style

常見問題

What is progressive disclosure in skills?

A three-level loading system: metadata always loaded, SKILL.md body when triggered, references/ content only when Claude needs it.

How long should SKILL.md be?

Target 1500-2000 words for the body. Move detailed content to references/ files which can be 2000-5000+ words each.

Why use third person in descriptions?

Third person format like 'This skill should be used when...' helps Claude's skill selection logic match user requests reliably.

When should I use scripts/ vs references/?

Use scripts/ for executable code that runs repeatedly. Use references/ for documentation Claude reads for context.

Do plugin skills need packaging?

No. Plugin skills are distributed as part of the plugin itself. Users get skills automatically when installing the plugin.

How do I test if my skill triggers correctly?

Install the plugin locally with --plugin-dir flag and ask questions that should trigger the skill. Verify it loads correctly.

開發者詳情

作者

davila7

授權

UNLICENSED

儲存庫

https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/development/skill-development

引用

main

檔案結構

📁 references/

📄 skill-creator-original.md

📄 SKILL.md