optimize-skill

Optimize Skill

Guide for analyzing, editing, and optimizing existing Datus skills based on real usage data.

Step 1: Identify Target Skill

Use load_skill(skill_name="<name>") to load the current SKILL.md content.

Present to the user:

• Current name, description, tags
• Summary of key instruction sections
• Whether it has scripts, references, or other resources

Ask the user what aspect needs improvement (or proceed to analysis if they said "optimize").

Step 2: Find Usage Sessions

Search for sessions where this skill was invoked. Look at the action history and tool call records:

• Search for load_skill calls with this skill name in recent action histories
• Identify which agent nodes loaded this skill
• Find the corresponding execute_stream sessions

This gives real-world data on how the skill was actually used.

Step 3: Analyze Tool Call Patterns

From the usage sessions, identify:

• Which tools were called after loading the skill — does the agent follow the skill's instructions?
• What failed — tool errors, retries, dead ends
• Where the agent got stuck — excessive tool calls, circular patterns, repeated queries