skill-building

Guide creation of Claude Code skills with frontmatter specifications and content best practices.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/WebSmartTeam/COR-CODE --skill skill-building-websmartteam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-building
Source: https://github.com/WebSmartTeam/COR-CODE/tree/main/skills/skill-building
Command: npx skills add https://github.com/WebSmartTeam/COR-CODE --skill skill-building-websmartteam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide and best practices for creating robust and efficient Claude Code skills and agents, ensuring they are discoverable, maintainable, and aligned with project needs.

Core Features & Use Cases

  • Skill & Agent Structure: Defines the recommended YAML frontmatter and content structure for both skills and agents.
  • Scope Management: Differentiates between global and project-specific skills and agents.
  • Core Principle & Formula: Explains the "References, Pet Hates, Post-training" formula for effective skill content.
  • Content Guidelines: Advises on what to include and exclude from skill documentation to avoid over-documenting.
  • Use Case: A developer needs to create a new skill for their project to enforce specific coding standards. They consult this skill to understand the correct frontmatter, how to define project-specific preferences, and what kind of information is most valuable to include.

Quick Start

Use the skill-building skill to understand the official frontmatter specification for Claude Code skills.

Frequently Asked Questions about skill-building

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

FAQPage Schema
How do I create effective Claude Code skills and agents?

To create effective Claude Code skills and agents, structure your documentation using official YAML frontmatter specifications and follow the "References, Pet Hates, Post-training" formula to provide context and nudge behavior.

What information should I include when building a Claude skill?

When building a Claude skill, include references, specific project preferences or pet hates, and post-training data to create thin wrappers around Claude's knowledge, avoiding over-documentation to maintain maintainability.

How does scope management work for Claude skills and agents?

Scope management for Claude skills and agents differentiates between global and project-specific implementations, ensuring your tools are discoverable and correctly aligned with your project's specific coding standards and needs.

What is the best way to enforce coding standards using Claude agents?

The best way to enforce coding standards with Claude agents is to create project-specific skills that define preferences and point to resources, leveraging thin wrappers to nudge Claude's behavior according to your requirements.

Why should I avoid over-documenting Claude skill content?

You should avoid over-documenting Claude skill content because effective skills act as thin wrappers around Claude's knowledge, relying on concise references and post-training data rather than extensive documentation to guide behavior.