gh-francyjglisboa-agent-skill-creator/references/templates/README-activation-template.md

{{Skill Name}}

Version: {{version}} Type: {{Simple Skill / Skill Suite}} Created by: Agent-Skill-Creator v{{version}}

---

Overview

{{Brief description of what the skill does and why it's useful}}

Key Features

• {{Feature 1}}
• {{Feature 2}}
• {{Feature 3}}

---

Installation

# Installation instructions
{{installation-commands}}

---

🎯 Skill Activation

This skill uses a 3-Layer Activation System for reliable detection.

✅ Phrases That Activate This Skill

The skill will automatically activate when you use phrases like:

Primary Activation Phrases

1. "{{keyword-phrase-1}}"

   • Example: "{{example-1}}"

2. "{{keyword-phrase-2}}"

   • Example: "{{example-2}}"

3. "{{keyword-phrase-3}}"

   • Example: "{{example-3}}"

Workflow-Based Activation

4. "{{workflow-phrase-1}}"

   • Example: "{{example-4}}"

5. "{{workflow-phrase-2}}"

   • Example: "{{example-5}}"

Domain-Specific Activation

6. "{{domain-phrase-1}}"

   • Example: "{{example-6}}"

7. "{{domain-phrase-2}}"

   • Example: "{{example-7}}"

Natural Language Variations

8. "{{natural-variation-1}}"

   • Example: "{{example-8}}"

9. "{{natural-variation-2}}"

   • Example: "{{example-9}}"

10. "{{natural-variation-3}}"

    • Example: "{{example-10}}"

❌ Phrases That Do NOT Activate

To prevent false positives, this skill will NOT activate for:

1. {{counter-case-1}}

   • Example: "{{counter-example-1}}"
   • Reason: {{reason-1}}

2. {{counter-case-2}}

   • Example: "{{counter-example-2}}"
   • Reason: {{reason-2}}

3. {{counter-case-3}}

   • Example: "{{counter-example-3}}"
   • Reason: {{reason-3}}

💡 Activation Tips

To ensure reliable activation:

DO:

• ✅ Use action verbs: {{verb-examples}}
• ✅ Be specific about: {{context-requirements}}
• ✅ Mention: {{entity-keywords}}
• ✅ Include context: {{context-examples}}

DON'T:

• ❌ Use vague phrases like "{{vague-example}}"
• ❌ Omit key entities like "{{missing-entity}}"
• ❌ Be too generic: "{{generic-example}}"

🎯 Example Activation Patterns

Pattern 1: {{Pattern-description-1}}

User: "{{example-query-1}}"
Result: ✅ Skill activates via {{layer-name}}

Pattern 2: {{Pattern-description-2}}

User: "{{example-query-2}}"
Result: ✅ Skill activates via {{layer-name}}

Pattern 3: {{Pattern-description-3}}

User: "{{example-query-3}}"
Result: ✅ Skill activates via {{layer-name}}

---

Usage

Basic Usage

{{basic-usage-example}}

Advanced Usage

{{advanced-usage-example}}

Real-World Examples

Example 1: {{Example-title-1}}

User Query:

"{{example-query-1}}"

Skill Actions:

1. {{action-step-1}}
2. {{action-step-2}}
3. {{action-step-3}}

Output:

{{example-output-1}}

Example 2: {{Example-title-2}}

User Query:

"{{example-query-2}}"

Skill Actions:

1. {{action-step-1}}
2. {{action-step-2}}
3. {{action-step-3}}

Output:

{{example-output-2}}

---

Features

Feature 1: {{Feature-name}}

{{Description of feature 1}}

Activation:

• "{{feature-1-query}}"

Example:

{{feature-1-example}}

Feature 2: {{Feature-name}}

{{Description of feature 2}}

Activation:

• "{{feature-2-query}}"

Example:

{{feature-2-example}}

---

Configuration

Optional Configuration

{{Configuration-instructions}}

{{configuration-example}}

---

Troubleshooting

Issue: Skill Not Activating

Symptoms: Your query doesn't activate the skill

Solutions:

1. ✅ Use one of the activation phrases listed above
2. ✅ Include action verbs: {{verb-list}}
3. ✅ Mention specific entities: {{entity-list}}
4. ✅ Provide context: "{{context-example}}"

Example Fix:

❌ "{{vague-query}}"
✅ "{{specific-query}}"

Issue: Wrong Skill Activates

Symptoms: A different skill activates instead

Solutions:

1. Be more specific about this skill's domain
2. Use domain-specific keywords: {{domain-keywords}}
3. Add context that distinguishes from other skills

Example Fix:

❌ "{{ambiguous-query}}"
✅ "{{specific-query-with-context}}"

---

Testing

Activation Test Suite

You can verify activation with these test queries:

1. "{{test-query-1}}" → Should activate ✅
2. "{{test-query-2}}" → Should activate ✅
3. "{{test-query-3}}" → Should activate ✅
4. "{{test-query-4}}" → Should activate ✅
5. "{{test-query-5}}" → Should activate ✅
6. "{{test-query-6}}" → Should NOT activate ❌
7. "{{test-query-7}}" → Should NOT activate ❌

---

FAQ

Q: Why isn't the skill activating for my query?

A: Make sure your query includes:

• Action verb ({{verb-examples}})
• Entity/object ({{entity-examples}})
• Specific context ({{context-examples}})

See the "Activation Tips" section above.

Q: How do I know which phrases will activate the skill?

A: Check the "Phrases That Activate This Skill" section above for 10+ tested examples.

Q: Can I use variations of the activation phrases?

A: Yes! The skill uses regex patterns and Claude's NLU, so natural variations will work. For example:

• "{{variation-1}}" ✅
• "{{variation-2}}" ✅
• "{{variation-3}}" ✅

---

Technical Details

Architecture

{{Architecture-description}}

Components

• {{Component-1}}: {{Description}}
• {{Component-2}}: {{Description}}
• {{Component-3}}: {{Description}}

Dependencies

{{dependencies-list}}

---

Contributing

{{Contributing-guidelines}}

---

License

{{License-information}}

---

Changelog

v{{version}} ({{date}})

• {{change-1}}
• {{change-2}}
• {{change-3}}

---

Support

For issues or questions:

• {{support-contact}}

---

Generated by: Agent-Skill-Creator v{{version}} Last Updated: {{date}} Activation System: 3-Layer (Keywords + Patterns + Description)