instruction-writer

Write and optimize Claude Code instructions for clarity and token efficiency.

3|Updated Feb 26, 2023
One-click install
npx skills add https://github.com/appaquet/dotfiles --skill instruction-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instruction-writer
Source: https://github.com/appaquet/dotfiles/tree/main/home-manager/modules/claude/skills/instruction-writer
Command: npx skills add https://github.com/appaquet/dotfiles --skill instruction-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Crafting effective, token-efficient instructions for AI agents is complex and time-consuming. This Skill automates the application of prompt engineering best practices, ensuring your Claude Skills, slash commands, and memory files are clear, concise, and performant, saving you significant development time.

Core Features & Use Cases

  • Instruction Generation: Automatically drafts new Claude Skills, slash commands, and memory files, adhering to the latest prompt engineering guidelines.
  • Prompt Optimization: Refines existing instructions for clarity, specificity, and token efficiency, identifying and correcting issues like verbosity or weak examples.
  • Use Case: Need to create a new Claude Skill for a specific task? Simply describe its purpose, and this Skill will generate the SKILL.md with optimal structure, examples, and cross-references, allowing you to focus on the core logic rather than prompt mechanics.

Quick Start

Write a new Claude Skill for analyzing financial reports. Optimize the attached SKILL.md for token efficiency and clarity.

Frequently Asked Questions about instruction-writer

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

FAQPage Schema
How do I write optimized Claude instructions for my AI agents?

Optimized Claude instructions apply prompt engineering best practices: clear structure, specific examples, minimal verbosity, and token efficiency. This Skill automates drafting and refining instructions for Skills, commands, and memory files, ensuring they follow canonical formatting and performance guidelines without manual iteration.

Can I automate prompt engineering for new Claude Skills?

Yes. Describe your Skill's purpose, and this Skill generates the complete SKILL.md with optimal structure, examples, and cross-references adhering to best-practice guidelines. You focus on core logic while the Skill handles prompt mechanics and token optimization.

What's the best way to reduce token usage in AI instructions?

Token efficiency comes from removing verbosity, strengthening examples, and applying structured formatting. This Skill identifies bloat and clarity issues in existing instructions, refining them for specificity and conciseness while preserving intent and completeness.

How do I improve clarity and consistency across my Claude documentation?

Effective documentation uses canonical terminology, explicit examples, and structured formatting. This Skill refines your SKILL.md, slash commands, and memory files for consistency, clarity, and adherence to prompt engineering best practices across all linked files.

Does prompt engineering apply to slash commands and memory files?

Yes. Prompt engineering principles extend beyond Skills to slash commands and memory files. This Skill applies the same optimization and clarity improvements across all instruction-based components, ensuring token efficiency and consistent best-practice formatting.

What's involved in creating effective AI agent instructions?

Effective instructions require structured formatting, explicit examples, minimal verbosity, and adherence to prompt engineering guidelines. This Skill automates this process by generating, optimizing, and documenting instructions for Skills, commands, and memory files with built-in best practices.