Aha-Loop: Skill for Claude Code

Skill Creator

Creates well-structured Skills following Anthropic's official best practices.

When to Create a Skill

Good candidates:

• Repeated 3+ times
• Complex multi-step workflows
• Error-prone processes
• Domain-specific knowledge

Not worth codifying:

• One-off tasks
• Highly variable processes
• Trivial single-step actions

SKILL.md Structure

Required Frontmatter

---
name: processing-documents
description: "Processes documents and extracts data. Use when working with PDF or Word files. Triggers on: process document, extract data."
---

Field requirements:

Field	Rules
name	Max 64 chars, lowercase letters/numbers/hyphens only
description	Max 1024 chars, non-empty, use third person

Naming Convention

Use gerund form (verb + -ing):

• processing-pdfs
• analyzing-spreadsheets
• managing-databases

Avoid: helper, utils, tools, anthropic-*, claude-*

Writing Descriptions

Always use third person (injected into system prompt):

# Good
description: "Processes Excel files and generates reports"

# Avoid
description: "I can help you process Excel files"
description: "You can use this to process Excel files"

Be specific and include triggers:

description: "Analyzes BigQuery data and generates reports. Use when querying sales metrics or creating dashboards. Triggers on: analyze data, bigquery report, sales metrics."

Skill Body Template

# [Skill Title]

[One sentence describing what this skill does]

## Quick Start

[Minimal example to get started - under 50 tokens]

## Process

1. [Step 1]
2. [Step 2]
3. [Step 3]

## Advanced Features

**[Feature A]**: See [FEATURE_A.md](FEATURE_A.md)
**[Feature B]**: See [FEATURE_B.md](FEATURE_B.md)

Best Practices

Be Concise

Only add context Claude doesn't already have. Challenge each piece:

• "Does Claude really need this explanation?"
• "Can I assume Claude knows this?"