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.