Why shouldn't I use XML tags in a Claude Code Skill?

Claude Code Skills are designed to use standard Markdown headings for structure. Using XML tags is considered an anti-pattern as it deviates from the official specification and can affect parsing.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior by providing domain-specific guidance, best practices, and implementation patterns via a standardized SKILL.md file.

What is the recommended file length for SKILL.md?

The official recommendation is to keep the SKILL.md file under 500 lines. Detailed content should be moved to reference files using the progressive disclosure pattern.

How should I name my custom Claude Code skill?

Use the gerund form (verb ending in -ing) with lowercase letters, numbers, and hyphens. Examples include 'processing-data' or 'reviewing-code'.

Agent Skill Architect

Name: Agent Skill Architect
Author: nilpath

bynilpath

0•

学習とドキュメンテーション

Provides expert guidance for creating, auditing, and refining high-performance Claude Code Skills following official specifications.

The Agent Skill Architect is a specialized tool designed to help developers master the creation of Claude Code Skills. It provides a structured framework for authoring SKILL.md files, ensuring proper YAML frontmatter usage, adherence to the gerund naming convention, and implementation of progressive disclosure for complex workflows. By enforcing standard markdown patterns and avoiding common anti-patterns like XML tags, this skill ensures that custom extensions are highly discoverable, modular, and optimized for Claude's reasoning capabilities.

主な機能

010 GitHub stars

02Guidance on progressive disclosure for managing complex file structures

03Templates for common patterns including workflows, checklists, and reports

04Detection and correction of anti-patterns such as XML tags or vague descriptions

05Standardized YAML frontmatter generation and validation

06Comprehensive audit rubric for evaluating existing skill quality and performance

ユースケース

01Auditing third-party skills for compliance with Anthropic best practices

02Authoring new domain-specific Claude Code extensions from scratch

03Refactoring monolithic prompts into modular, maintainable agent skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nilpath/nilpath-marketplace create-agent-skills

For use in Claude.ai and ChatGPT

Download Skill