Skills
.Work. You
Rest

skill-file-structure

Community

Standardize Skill layout for easy collaboration.

Software Engineering#assets#scripts#best-practices#frontmatter#references#skill-structure#file-structure
Authorkissrosecicd-hub
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This guide standardizes how to structure a Skill unit to separate metadata from code and resources, reducing confusion and improving collaboration.

Core Features & Use Cases

  • Encourages a consistent layout: SKILL.md at the root, with optional scripts/, references/, and assets/ directories to house executable code and resources.
  • Prevents inline scripting in SKILL.md by moving code to dedicated files under scripts/.
  • Improves maintainability when creating, updating, or sharing skills across teams and projects.

Quick Start

Create a new skill folder at .agents/skills/<name>/ with a SKILL.md frontmatter and place any executable scripts in scripts/ next to it.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: skill-file-structure
Download link: https://github.com/kissrosecicd-hub/agents-evolution/archive/main.zip#skill-file-structure

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.