---
name: skill-template
description: Template for creating new agentic coding skills
---

# Skill Template

[Replace with a clear description of what this skill does and the problem it solves]

## When to Use

Invoke this skill when the user requests:
- [List specific phrases or requests that should trigger this skill]
- [Example: "Document today's work"]
- [Example: "Update the spec-kit ecosystem"]
- [Example: "Create a comprehensive worklog"]

## Context Gathering

Before executing the skill, gather necessary context using appropriate tools:

**Git Information** (if applicable):
- Current git status: `git status`
- Recent commits: `git log --oneline -10`
- Active branch: `git branch --show-current`
- Uncommitted changes: `git diff --stat`

**File System Information** (if applicable):
- Check for required directories
- Verify necessary files exist
- Locate configuration files

**External Dependencies** (if applicable):
- Check for required tools/commands
- Verify API access or credentials
- Validate configuration settings

## Process

[Detailed step-by-step instructions for the agent to follow]

1. **Preparation**
   - Verify all prerequisites are met
   - Gather necessary context (see Context Gathering section)
   - Check for conflicts or blockers

2. **Execution**
   - [Specific action 1]
   - [Specific action 2]
   - [Specific action 3]

3. **Validation**
   - Verify expected outputs were created
   - Check for errors or warnings
   - Validate content meets quality standards

4. **Completion**
   - Report summary of actions taken
   - Provide next steps or recommendations
   - Clean up temporary files if applicable

## Helper Scripts

[Document any helper scripts in the scripts/ directory]

### script-name.sh

**Purpose**: [What this script does]

**Usage**:
```bash
./scripts/script-name.sh [arguments]
```

**Output**: [What the script returns]

## Assets

[Document any assets in the assets/ directory]

### template-file.ext

**Purpose**: [What this template is used for]

**Placeholders**:
- `[PLACEHOLDER_1]`: [Description]
- `[PLACEHOLDER_2]`: [Description]

## Examples

See the `examples/` directory for example outputs and usage patterns.

## Guidelines

[Specific guidelines for how the agent should behave when using this skill]

1. **Principle 1**: [Description]
2. **Principle 2**: [Description]
3. **Principle 3**: [Description]

## Error Handling

[How to handle common errors or edge cases]

- **Error Scenario 1**: [How to handle]
- **Error Scenario 2**: [How to handle]
- **Error Scenario 3**: [How to handle]

## Requirements

[List all dependencies and prerequisites]

- Dependency 1 (e.g., Git repository)
- Dependency 2 (e.g., Bash environment)
- Dependency 3 (e.g., Specific CLI tool)
- Optional: Dependency 4 (e.g., Internet connection for API calls)

## Output Format

[Describe what the skill produces]

- File(s) created: [List files and locations]
- Terminal output: [What is displayed to user]
- Side effects: [Any state changes, commits, etc.]

## Testing

[How to verify this skill works correctly]

1. **Test Case 1**: [Scenario and expected outcome]
2. **Test Case 2**: [Scenario and expected outcome]
3. **Test Case 3**: [Scenario and expected outcome]

## Notes

[Additional context, limitations, or considerations]

- Note 1
- Note 2
- Note 3
