skills.rest
mgd34msu
mgd34msuCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-descriptions

Write agent and skill descriptions with trigger-specific formulas.

4|Updated Jan 15, 2026
Search Tags:#prompt engineering#AI assistant#agent prompts#skill invocation#description writing
One-click install
npx skills add https://github.com/mgd34msu/goodvibes-gemini --skill writing-descriptions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-descriptions
Source: https://github.com/mgd34msu/goodvibes-gemini/tree/main/skills/writing-descriptions
Command: npx skills add https://github.com/mgd34msu/goodvibes-gemini --skill writing-descriptions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users write clear, concise, and effective descriptions for AI agents and skills, ensuring they are correctly invoked and understood.

Core Features & Use Cases

  • Description Formula: Provides a template for crafting robust descriptions ({Role/expertise}. Use [PROACTIVELY] when {specific trigger conditions}.).
  • Examples: Offers numerous examples for both agent and skill descriptions across various categories.
  • Proactive vs. On-Demand Guidance: Explains when to use the PROACTIVELY keyword for automatic invocation.
  • Trigger Specificity: Guides users on making trigger conditions precise for reliable invocation.
  • Use Case: A new AI developer needs to create a skill for handling Docker issues. They use this Skill to learn how to write a description like: "Docker troubleshooter. Use PROACTIVELY when containers fail to start, crash, or behave unexpectedly."

Quick Start

Use the writing-descriptions skill to generate a description for a new skill that helps with Git branching.

Frequently Asked Questions about writing-descriptions

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

FAQPage Schema
How do I write an AI agent description that triggers reliably?▼

To write an AI agent description that triggers reliably, use a structured formula combining role expertise with specific trigger conditions. This ensures your description is clear, actionable, and optimized for AI routing decisions.

What is the best format for skill descriptions to ensure correct invocation?▼

The best format for skill descriptions follows the template: `{Role/expertise}. Use [PROACTIVELY] when {specific trigger conditions}.`. This structure addresses unreliable invocation caused by vague formatting.

When should I use the PROACTIVELY keyword in agent prompts?▼

Use the PROACTIVELY keyword in agent prompts when you need automatic invocation for specific events. This distinguishes proactive triggers from on-demand requests, ensuring the AI acts without explicit user commands.

Why does my AI assistant fail to invoke skills with vague descriptions?▼

AI assistants fail to invoke skills with vague descriptions because poorly formatted text impairs routing decisions. Making trigger conditions precise and actionable directly solves this invocation problem.

Can I use a description template for various categories of AI skills?▼

You can use the description template across various categories by adapting the role and trigger conditions. The skill provides numerous examples for both agent and skill descriptions to guide category-specific formatting.

Related Skills

Explore More Content & Communication Skills→
huiferhuifer
1

prime-product-desc

Generate PRIME-compliant product descriptions with structured sections and SEO optimization.

Community
Advanced
pproencapproenca

testing-skills-with-subagents

Test AI agent skills under pressure scenarios using subagents.

Community
Basic
chaorenex1chaorenex1
3

codex

Generate a reference-based AGENTS.md from CLAUDE.md for Claude Code projects.

Community
Intermediate
gman-roboticsgman-robotics

video-generation

Generate videos from JSON prompts and reference images via Python script.

Official
Intermediate