skill-name-required-kebab-case-matches-directory-name

name	<skill-name>
description	<Brief description of what this skill does and when to invoke it. Should be ≤200 characters for clean harness rendering.>
license	Proprietary
compatibility	agentic-engineers framework v5.10+. Requires Python 3.11+
metadata	{"author":"agentic-engineers","version":"1.0","category":"<category>","role":"<role>","model":"<model>","effort":"<effort>","thinking":false,"dependencies":[],"trigger":"on-demand","tdd_phase":"RED"}

Overview

.

What it does:

1. <Step 1 name> —
2. <Step 2 name> —
3. <Step 3 name> —

Why it matters:

• <Benefit 1> —
• <Benefit 2> —

---

Invocation

Python API (preferred)

from src.skills.<skill_name> import <SkillClass>

# Initialize and run
skill = <SkillClass>()
result = skill.run(<args>)
print(result)

CLI

python src/skills/<skill-name>/scripts/<skill_name>.py \
  --<arg1> <value1> \
  --<arg2> <value2>

Automated Trigger

# In .github/workflows/ci.yml:
- name: <Skill Name>
  run: python src/skills/<skill-name>/scripts/<skill_name>.py

---

Integration

Input: <What the skill consumes — file paths, environment vars, CLI args> Output: <What the skill produces — report, JSON, exit code, side-effects> Used by: Calls:

---

Configuration

Parameter	Type	Required	Default	Description
<param1>	str	✅	—
<param2>	int	❌	10
<param3>	bool	❌	false

Allowed Categories

orchestration · validation · monitoring · optimization · observability · scaffolding · integration · queue · metrics · maintenance · hygiene · management · security

Allowed Roles

engineer · senior-engineer · lead-engineer · principal-engineer · security-engineer · quality-engineer · orchestrator

Allowed Models

Tier	Model	Recommended for
Haiku (fast/cheap)	claude-haiku-4.5	engineer, orchestrator
Sonnet (balanced)	claude-sonnet-4.5, claude-sonnet-4.6	senior, lead, quality
Opus (powerful)	claude-opus-4.7, claude-opus-4.8	principal, security
OpenAI	gpt-4o-mini, gpt-4o, gpt-5-mini	special cases
Gemini	gemini-3.5-flash, gemini-3.1-pro-preview	special cases

---

Tests

python -m pytest src/skills/<skill-name>/tests/ -v
# Expected: N tests, M% coverage

---

Scripts

• scripts/<skill_name>.py — Core implementation entry point

---

DELEGATE / HANDBACK Protocol

Example DELEGATE

---
handoff_type: DELEGATE
task_id: <YYYY-MM-DD-skill-name-task>
timestamp: <ISO8601>
role: <role>
model: <model>
effort: <effort>
scope: >
  <What needs to be done — 1–3 sentences>
context:
  - <key context item 1>
  - <key context item 2>
---

Example HANDBACK

---
handoff_type: HANDBACK
task_id: <YYYY-MM-DD-skill-name-task>
timestamp: <ISO8601>
status: success
deliverables:
  - <file or artifact produced>
quality_score: 95
confidence: 0.95
tokens:
  used: <N>
  efficiency: 0.9
notes: "<What was done and any notable findings>"
---