writing-skills

Create Claude Agent Skills with structured SKILL.md templates and naming guidelines.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/qaml-ai/acon --skill writing-skills-qaml-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/qaml-ai/acon/tree/main/.claude/skills/writing-skills
Command: npx skills add https://github.com/qaml-ai/acon --skill writing-skills-qaml-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured approach to create and maintain Agent Skills for Claude, offering guidance on naming conventions, description writing, and progressive disclosure strategies to enhance discoverability and usability.

Core Features & Use Cases

  • Skill Creation Guidance: Offers detailed instructions for structuring SKILL.md files, including naming rules and description requirements.
  • Best Practices: Provides guidelines on writing effective descriptions, naming conventions, and progressive disclosure techniques.
  • Use Case: Use this Skill when starting a new Claude skill project or when refining an existing skill to ensure it follows best practices and is easily discoverable by Claude.

Quick Start

Create a new Claude skill using the following template and guidelines from the skill:

---
name: "your-skill-name"
description: What it does and when to use it. Always third person.
---

Frequently Asked Questions about writing-skills

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

FAQPage Schema
What are the best practices for writing Claude Agent Skills descriptions?

Best practices for Claude Agent Skills descriptions require writing in the third person, clearly stating what the skill does and when to use it. This approach ensures optimal discoverability and usability when Claude evaluates and invokes skills.

How do I structure a SKILL.md file for Claude skill creation?

Structure a SKILL.md file using YAML frontmatter containing the name and description fields. Follow naming conventions and apply progressive disclosure strategies to manage skill content for optimal Claude performance and discoverability.

What is progressive disclosure in Claude skill template design?

Progressive disclosure in Claude skill template design is a strategy to manage skill content by structuring information in layers. It enhances discoverability by ensuring Claude processes the most relevant skill details without being overwhelmed by excessive content.

Do I need any dependencies to create and manage Claude skills?

No dependencies are required to create and manage Claude skills. You can start a new project or refine an existing skill using only the provided structured templates and guidelines to ensure proper naming and content structure.

When should I use a structured template for Claude skill creation?

Use a structured template for Claude skill creation when starting a new skill project or refining an existing one. It ensures your skill follows naming conventions, description requirements, and progressive disclosure techniques for easy discoverability by Claude.

What naming conventions should I follow for Claude Agent Skills?

Naming conventions for Claude Agent Skills require using lowercase and a specific structure within the SKILL.md file. Following these rules ensures proper skill identification, management, and optimal performance when Claude evaluates the skill.