bx-skill-writer

Author, structure, and validate Claude Skills with SKILL.md frontmatter.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bitranox/bx_skills --skill bx-skill-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bx-skill-writer
Source: https://github.com/bitranox/bx_skills/tree/main/src/bx_skills/catalog_skills/bx-skill-writer
Command: npx skills add https://github.com/bitranox/bx_skills --skill bx-skill-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams author, structure, and validate Claude Skills by codifying frontmatter patterns, standard sections, and testing workflows to ensure consistent discoverability and safe deployments.

Core Features & Use Cases

  • Frontmatter scaffolding and validation to enforce required fields like name and description.
  • Progressive disclosure guidance and hub/reference organization to manage heavy references without loading all content upfront.
  • Testing guidance with red-green-refactor cycles and CSO-conscious description to improve reliability and discoverability.

Quick Start

Create SKILL.md with the required frontmatter, then structure the body using standard sections and plan a RED-GREEN-REFACTOR testing cycle before deployment.

Frequently Asked Questions about bx-skill-writer

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

FAQPage Schema
How do I structure and validate YAML frontmatter for Claude Skills?

To validate Claude Skill frontmatter, scaffold required YAML fields like name and description within SKILL.md, ensuring correct syntax and CSO-aligned routing for safe deployments.

What is progressive disclosure in skill authoring and when should I use it?

Progressive disclosure in skill authoring manages heavy reference materials by organizing hub content without loading everything upfront, ensuring efficient Claude Skill execution and discoverability.

How do I apply TDD workflows to write and test Claude Skills?

Apply TDD to Claude Skill writing by planning a red-green-refactor testing cycle before deployment, validating frontmatter correctness and progressive disclosure to improve reliability.

What are the required frontmatter fields for a valid SKILL.md file?

A valid SKILL.md file requires YAML frontmatter fields including name and description, which are enforced through frontmatter scaffolding and validation to ensure discoverability.

Can I use this skill authoring workflow for large reference materials?

Yes, skill authoring supports large reference materials by applying progressive disclosure guidance and hub/reference organization, preventing heavy content from loading upfront during execution.

Why does my Claude Skill fail to deploy correctly?

Claude Skill deployment failures often stem from incorrect YAML frontmatter fields or missing standard sections, which frontmatter validation and red-green-refactor testing cycles prevent.