Browse / Learning Documentation / Instruction Writer

Instruction Writer

Writes and optimizes clear, token-efficient instructions for all Claude Code components, including skills, commands, and documentation.

SkillLearning DocumentationSkill AuthoringAgent BehaviorDocs Standards

The source repository doesn't declare a license. Check its terms before reusing the code.

Key features

  • Analyzes and reports on potential improvements before applying changes
  • Structures content with headers and XML tags for better AI parsing
  • Writes new instructions for skills, commands, and CLAUDE.md files
  • Applies prompt engineering best practices from a central guide
  • Optimizes existing prompts for clarity and token efficiency

Use cases

  • Creating a new Claude Code Skill or slash command
  • Refining a project's CLAUDE.md file to improve AI guidance
  • Optimizing a verbose prompt to reduce token cost and increase clarity

FAQ

When should I use this skill?

This skill is automatically and mandatorily used whenever you create or modify core Claude Code files like SKILL.md or CLAUDE.md. It also triggers when you explicitly ask Claude to "write instructions" or "optimize a prompt".

What does the Instruction Writer skill do?

The Instruction Writer skill specializes in creating and refining instructions for all Claude Code components. It ensures your prompts for skills, commands, and documentation are clear, token-efficient, and structured for optimal AI performance.

What capabilities does it provide?

It can write new instructions from scratch, optimize existing ones for clarity and token usage, apply formatting like XML tags for better AI parsing, and analyze prompts to report potential improvements before making changes.

How does this skill improve my workflow?

It automates the application of prompt engineering best practices, ensuring all your custom instructions are high-quality and consistent. This saves you time and leads to more reliable and efficient behavior from Claude.