Skill Development

Guide creation and structuring of Claude Code skills with SKILL.md best practices.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tktaf/codex --skill skill-development-tktaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/tktaf/codex/tree/main/skills/skill-development
Command: npx skills add https://github.com/tktaf/codex --skill skill-development-tktaf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and best practices for creating, structuring, and improving Claude Code skills, ensuring they are discoverable, efficient, and effective.

Core Features & Use Cases

  • Skill Structure Guidance: Understand the anatomy of a skill, including SKILL.md, scripts/, references/, and assets/.
  • Best Practice Adherence: Learn about progressive disclosure, writing style (imperative, third-person), and content organization.
  • Use Case: A developer needs to create a new skill for their plugin. They can use this Skill to understand the required file structure, how to write an effective SKILL.md, and where to place supporting documentation and scripts.

Quick Start

Follow the step-by-step guide to create a new skill for your plugin.

Frequently Asked Questions about Skill Development

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

FAQPage Schema
How do I structure a Claude Code skill for plugin development?

To structure a Claude Code skill, create a `SKILL.md` file alongside bundled resources like `scripts/`, `references/`, and `assets/` directories. This organization ensures your AI skills are discoverable, efficient, and effective.

What are the best practices for writing SKILL.md content?

Best practices for SKILL.md content include using imperative, third-person writing style and organizing content through progressive disclosure. This approach ensures the skill's internal reasoning and documentation remain clear and effective.

What is progressive disclosure in AI skills?

Progressive disclosure is a best practice for organizing skill content, ensuring documentation and bundled resources are revealed efficiently. It guides users through creating and refining AI skills without overwhelming them.

How do I add scripts and references to a Claude Code skill?

Add scripts and references to a Claude Code skill by placing them in their respective `scripts/` and `references/` directories. This structure supports the skill's core logic and provides necessary documentation.

Can I use this skill to refine existing Claude Code skills?

Yes, you can use this skill to refine existing Claude Code skills by applying best practices for `SKILL.md` content, progressive disclosure, and writing style. It helps improve discoverability and efficiency.

What do I need to create a new skill for my plugin?

To create a new skill for your plugin, you need to understand the required file structure, including `SKILL.md`, scripts, and references. This skill provides step-by-step guidance for the entire process.