skills.rest
Takeaki0817
Takeaki0817COMMUNITY
Explore all skills by this author →
Website𝕏@dev_takeaki0817GitHub

skill-writer

Guide frontmatter, hierarchy, and file organization for Claude Skills.

Updated Dec 16, 2025
One-click install
npx skills add https://github.com/Takeaki0817/hibioru --skill skill-writer-takeaki0817
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/Takeaki0817/hibioru/tree/main/.claude/skills/skill-writer
Command: npx skills add https://github.com/Takeaki0817/hibioru --skill skill-writer-takeaki0817

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Writer helps authors craft well-structured Claude Skills by enforcing frontmatter rules, consistent naming, and clear documentation patterns to ensure reliable discovery and activation.

Core Features & Use Cases

  • Frontmatter enforcement: ensures name and description exist and follow conventions.
  • Scaffold guidance: provides a repeatable Skill layout (SKILL.md, optional reference.md, examples.md, scripts/, templates/).
  • Validation and best practices: provides guidance to validate structure and keep Skills maintainable.
  • Use cases: creating personal or project Skills, onboarding teammates, sharing reusable utilities.

Quick Start

Create a new Skill directory under .claude/skills/skill-name, add a SKILL.md with proper frontmatter, optionally add reference.md and examples.md, and run through validation suggestions.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I structure a Claude Skill with proper frontmatter?▼

To structure a Claude Skill, create a directory under .claude/skills/, add a SKILL.md file with compliant frontmatter, and use progressive disclosure by linking to optional reference.md and examples.md files.

What is the correct file organization for creating reusable Claude Skills?▼

The correct file organization for Claude Skills uses a main SKILL.md for instructions, supplemented by separate reference.md and examples.md files, alongside optional scripts/ and templates/ directories for maintainability.

How do I validate frontmatter naming rules for a project Skill?▼

You validate frontmatter naming rules by ensuring the name and description fields exist and follow established conventions, which guarantees reliable discovery and activation of the Skill within the Claude environment.

Does Skill Writer work for both personal and project-level Skill scaffolding?▼

Yes, Skill Writer scaffolds both personal and project-level Skills by clarifying scope, location, and file organization, making it suitable for onboarding teammates and sharing reusable utilities.

What's the best way to document advanced usage in a Claude Skill?▼

The best way to document advanced usage is through progressive disclosure, placing detailed dependencies, examples, and advanced instructions in separate, linked files like examples.md rather than overloading the main SKILL.md.

Related Skills

the-agency-aithe-agency-ai
39

sandbox-init

Create standardized Claude Code sandbox directories and configuration files for engineers.

Official
Basic
pradyumnasagarpradyumnasagar
6

release-management

Manages ORS skill releases with versioning, changelogs, and marketplace updates.

Community
Intermediate
tsuji-tomonoritsuji-tomonori

obsidian-doc-check

Validate Obsidian markdown documents against project-specific conventions.

Community
Intermediate
softmgsoftmg

Skill Builder

Generate Claude Code Skills with standardized YAML frontmatter and progressive disclosure structure.

Official
Advanced