good-description-writing

Write precise routing descriptions for AI agent skills and tools.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/balandongiv/agent-skillbook --skill good-description-writing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: good-description-writing
Source: https://github.com/balandongiv/agent-skillbook/tree/main/skills/good-description-writing/exports/claude
Command: npx skills add https://github.com/balandongiv/agent-skillbook --skill good-description-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The problem of vague and ambiguous routing descriptions that cause incorrect or missed activations by AI agents.

Core Features & Use Cases

  • Clear, action-oriented routing phrases that uniquely identify a skill or tool
  • Guidance on when_to_use and when_not_to_use fields to refine triggers
  • Real-world examples of well-scoped descriptions for skills, tools, or functions

Quick Start

Write a precise routing description for a skill you want to activate in response to a user request.

Frequently Asked Questions about good-description-writing

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

FAQPage Schema
How do I write routing descriptions for AI agent skills?▼

To write routing descriptions for AI agent skills, start with a verb, name the output, include context, avoid filler words, and keep the description concise to ensure accurate activations across tools.

Why does my AI agent trigger the wrong skill?▼

Your AI agent triggers the wrong skill due to vague and ambiguous routing descriptions that cause incorrect or missed activations. Writing clear, action-oriented routing phrases that uniquely identify a tool prevents this.

What is the best way to use when_to_use fields for prompt engineering?▼

The best way to use when_to_use fields for prompt engineering is to apply guidance on when_to_use and when_not_to_use fields to refine triggers and ensure correct activations across skills and agents.

Do I need to start routing descriptions with a verb?▼

Yes, you need to start routing descriptions with a verb. This core rule for creating or editing description, summary, or when_to_use fields ensures your AI agent skills and tools trigger accurately.

Are there real-world examples of well-scoped descriptions for AI tools?▼

Yes, there are real-world examples of well-scoped descriptions for AI tools. These examples provide clear, action-oriented routing phrases that uniquely identify a skill or tool for precise prompt engineering.