skill-authoring

Document agent skills with SKILL.md frontmatter and structured Markdown sections.

51|16|Updated Oct 31, 2025

Search Tags:#development #documentation #guidelines #frontmatter #agent-skills #skill-authoring

Ready to run

npx skills add https://github.com/SalesforceCommerceCloud/b2c-developer-tooling --skill skill-authoring-salesforcecommercecloud

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/tree/main/.claude/skills/skill-authoring
Command: npx skills add https://github.com/SalesforceCommerceCloud/b2c-developer-tooling --skill skill-authoring-salesforcecommercecloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill authoring enables teams to define and discover user-facing agent skills via a consistent SKILL.md frontmatter and body structure, reducing ambiguity and enabling reliable agent activation.

Core Features & Use Cases

Frontmatter-first discovery: defines name and description for quick skill discovery.
Structured body for clear instructions: guides activation context and usage.
Optional resources directories (scripts, references, assets): support on-demand content and validation.

Quick Start

Create a folder for your skill with a SKILL.md containing a YAML frontmatter with name and description, followed by a Markdown body that provides instructions and examples. Optionally add scripts/, references/, and assets/ as needed to support the skill.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema

How do I create user-facing agent skills with consistent documentation?▼

Agent skill authoring organizes documentation by requiring a SKILL.md file with YAML frontmatter for name and description, a structured Markdown body for instructions, and optional resource directories for scripts and assets.

What is the required frontmatter for skill discovery in a development repository?▼

Mandatory skill frontmatter requires a YAML header in SKILL.md defining the name and description fields to enable quick discovery and reliable agent activation across a development repository.

What sections should I include when structuring agent skill documentation?▼

Structuring agent skill documentation requires explicit body sections for What problem does it solve, Core Features and Use Cases, and Quick Start to provide clear activation context and usage instructions.

Can I add resource directories to support user-facing agent skills?▼

You can optionally add scripts, references, and assets directories alongside SKILL.md to support on-demand content delivery and validation for user-facing agent skills.

Does skill authoring require any dependencies or external components?▼

Skill authoring requires no external dependencies or components, relying solely on standard YAML frontmatter and Markdown body structure in a SKILL.md file to define and maintain agent skills.