skills.rest
ThomasRohde
ThomasRohdeCOMMUNITY
Explore all skills by this author →
GitHub

skill-development

Create and refine AI skills with structured SKILL.md organization and progressive disclosure.

Updated Feb 14, 2026
Search Tags:#skill development#documentation#prompt engineering#progressive disclosure#developer guide#ai plugin
One-click install
npx skills add https://github.com/ThomasRohde/jarchi-scripting-system --skill skill-development-thomasrohde
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/ThomasRohde/jarchi-scripting-system/tree/main/.claude/skills/skill-development
Command: npx skills add https://github.com/ThomasRohde/jarchi-scripting-system --skill skill-development-thomasrohde

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 developing effective skills for AI assistants, ensuring they are discoverable, well-structured, and progressively disclose information.

Core Features & Use Cases

  • Skill Structure Guidance: Understand the anatomy of a skill, including SKILL.md and optional resources (scripts/, references/, assets/).
  • Progressive Disclosure: Learn how to manage context efficiently by loading information at different levels.
  • Writing Style Best Practices: Adhere to imperative/infinitive form and third-person descriptions for clarity.
  • Use Case: A developer wants to create a new skill for an AI plugin. They need to understand the required file structure, how to write effective descriptions and instructions, and how to organize supporting documentation and code.

Quick Start

Use the skill-development skill to learn how to create a new skill for an AI 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 an AI plugin skill for progressive disclosure?▼

Structure an AI plugin skill by organizing content into a `SKILL.md` file with optional `scripts/`, `references/`, and `assets/` directories to manage context efficiently at different levels.

What is the best writing style for AI assistant skill documentation?▼

The best writing style for skill documentation uses the imperative or infinitive form for instructions and third-person descriptions to ensure clear communication and optimal AI assistant performance.

How do I plan content for a new AI skill from scratch?▼

Plan AI skill content by following a detailed methodology covering skill anatomy, content planning, writing style, validation, and iteration to build a well-structured and discoverable assistant capability.

When do I need to use references and scripts in skill development?▼

Use `references/` and `scripts/` in skill development when you need to organize supporting documentation and code separately from the main `SKILL.md` to manage context efficiently through progressive disclosure.

How do I validate and iterate on an AI assistant skill?▼

Validate and iterate on an AI assistant skill by applying the provided methodology to refine `SKILL.md` content, test resource management, and ensure adherence to imperative writing styles for optimal performance.

Related Skills

Explore More Software Engineering Skills→
huahai2022huahai2022

setup

Install dependencies and configure the conda environment for ExecuTorch development.

Community
Intermediate
hainamchunghainamchung
54

agent-assistant-test-fast

Run the /test:fast workflow to test the Agent Assistant runtime boot and matrix-skills.

Community
Basic
lehuuhau1231lehuuhau1231

lint-and-validate

Run linting and type checking across multiple programming ecosystems.

Community
Intermediate
willyu1007willyu1007

author-developer-documentation

Author developer documentation with progressive disclosure, explicit requirements, examples, and verification steps.

Community
Basic