Skill Development

Name: Skill Development
Availability: InStock
Author: Powerhouse

Guide developers in creating and structuring Claude Code plugin skills.

Updated Feb 10, 2026

Search Tags:#skill development #best practices #documentation #plugin development #ai agent skills #claude code plugins

Ready to run

npx skills add https://github.com/powerhouse-inc/service-offering --skill skill-development-powerhouse-inc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: Skill Development
Source: https://github.com/powerhouse-inc/service-offering/tree/main/.agents/skills/Skill%20Development
Command: npx skills add https://github.com/powerhouse-inc/service-offering --skill skill-development-powerhouse-inc

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 refining skills for Claude Code plugins, 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 Practices: Learn about progressive disclosure, writing style (imperative/infinitive, third-person), and metadata quality.
Development Workflow: Follow a step-by-step process from understanding use cases to iteration and testing.
Use Case: A developer needs to create a new skill for their plugin to handle API documentation. They can use this Skill to understand how to structure the SKILL.md, where to place API reference documents in references/, and how to write clear, actionable instructions.

Quick Start

Use the Skill Development skill to learn how to create a new skill for a Claude Code plugin.

Frequently Asked Questions about Skill Development

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

FAQPage Schema

How do I create a new skill for a Claude Code plugin?▼

To create a Claude Code skill, structure your project with a SKILL.md file, a scripts/ directory, and a references/ folder. Follow a development workflow that progresses from understanding use cases to writing imperative instructions and testing the modular capabilities.

What is progressive disclosure in AI agent skills?▼

Progressive disclosure is a best practice for AI agent skills that structures documentation to reveal complexity gradually. It ensures skills remain discoverable and efficient by guiding the agent through foundational concepts before introducing advanced scripting and reference materials.

What writing style should I use for Claude Code plugin documentation?▼

Claude Code plugin documentation should use an imperative or infinitive writing style in the third person. This approach ensures instructions in the SKILL.md file are clear, actionable, and easily processed by AI agents executing modular tasks.

How do I structure API documentation references for an AI agent skill?▼

To structure API documentation references for an AI agent skill, place the reference documents inside the references/ directory. This separation from the main SKILL.md allows the agent to access detailed API schemas only when needed for specific tasks.

Can I use existing scripts when developing modular capabilities for Claude Code?▼

Yes, you can include existing scripts in the scripts/ directory when developing modular capabilities for Claude Code. This allows you to integrate pre-built automation logic directly into your AI agent skills alongside the main SKILL.md instructions.

What is the development workflow for refining Claude Code skills?▼

The workflow for refining Claude Code skills involves understanding use cases, structuring the SKILL.md anatomy, applying metadata quality standards, and conducting iteration and testing. This ensures the final plugin capabilities are effective and efficient.