skill-builder

Files (4)

• SKILL.md
• analyzer.md · agents/
• comparator.md · agents/
• grader.md · agents/

SKILL.md (first lines)

# DAX Skill Builder

Create and improve DAX skills with structured evaluation and iteration.

## Overview

DAX skills are markdown files with YAML frontmatter that provide specialized instructions to DAX agents. This skill guides you through creating, testing, and improving skills.

### When to Use This Skill

Use this skill when:

- User wants to create a new skill from scratch
- User wants to improve an existing skill
- User wants to test a skill with evaluations
- User wants to optimize skill triggering accuracy

---

## Creating a Skill

### Step 1: Capture Intent

Start by understanding what the user wants the skill to do:

1. What should this skill enable DAX to do?
2. When should this skill trigger? (user phrases, contexts)
3. What's the expected output format?
4. What tools or resources does it need?

### Step 2: Define the Skill Structure

Skills follow this structure:

```
skill-name/
├── SKILL.md           # Required - skill definition
├── scripts/           # Optional - helper scripts
├── references/        # Optional - reference docs
└── assets/            # Optional - templates, examples
```

### Step 3: Write SKILL.md

Required frontmatter:

```yaml
---
name: skill-name
description: |
  What this skill does and when to trigger it.
  Include specific contexts where this skill applies.
---
```

**Tips for descriptions:**

- Be specific about triggering contexts
- Include example phrases users might say
- Make it "pushy" - skills should be suggested when relevant

Example description:

```
Create documentation from code. Use when user mentions "document",
"docs", "readme", "API docs", or wants to generate documentation
for any code, files, or project.
```

### Step 4: Write the Body

Include:

- **Overview**: What the skill does
- **Process**: Step-by-step workflow
- **Guidelines**: Best practices and patterns
- **Examples**: Sample inputs/outputs

Keep it under 500 lines - reference external docs for deep dives.

---

## Testing Skills

### Test Cases

Create realistic test prompts in `evals/evals.json`:

```json
{
  "skill_name": "my-skill",
  "evals": [
    {
      "id": 1,
      "prompt": "User's task prompt",
      "expected_output": "Description of expected result"
    }
  ]
}
```

### Running Tests

Test the skill in DAX:

1. Place skill in `.dax/skills/` or `skills/`
2. Use `/skill <name>` to invoke
3. Run test prompts through DAX
4. Review outputs

### Evaluation Criteria

| Criteria         | Description                      |
| ---------------- | -------------------------------- |
| **Accuracy**     | Does it produce correct outputs? |
| **Completeness** | Does it handle all cases?        |
| **Triggering**   | Does it activate when needed?    |
| **Clarity**      | Are instructions clear?          |

From ShaileshRawat1403/dax, MIT.

More from ShaileshRawat1403/dax