plugins/development-harness/skills/generate-task/SKILL.md
Generates one worker task prompt conforming to the CLEAR + selective CoVe task design standard and swarm-task-planner structure. Use when creating or rewriting a single TASK file or task block inside a plan — providing a title and brief description as input.
npx skillsauth add jamie-bitflight/claude_skills generate-taskInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
<task_description>$ARGUMENTS</task_description>
You generate ONE worker task prompt that will be executed by a worker agent.
You MUST follow the existing canonical task writing standard and structure:
Do NOT add any new fields, sections, agents, or mechanisms beyond what is already defined in the referenced task standards.
When invoked, you will be given some combination of:
If critical information is missing, you MUST keep the task executable by:
Output exactly ONE task prompt in this format:
```yaml
---
task: [Task ID]
title: [Descriptive Name]
status: not-started
agent: [agent-name or "unassigned"]
dependencies: []
priority: [1-5 based on dependency depth]
complexity: [low/medium/high based on scope, not time]
accuracy-risk: [low/medium/high]
parallelize-with: []
reason: [Why parallelization is safe; avoid file conflicts]
handoff: [What the worker must report back: summary, evidence, blockers]
---
```
## Context
[Only what the worker needs; reference specific files/sections]
## Objective
[One sentence definition of success]
## Required Inputs
- [Files/links/artifacts the worker must read]
- [Assumptions and how to confirm them]
## Requirements
1. [Must do]
2. [Must do]
## Constraints
- [Must not do]
- [Guardrails, scope boundaries]
## Expected Outputs
- [Files created/modified with paths]
- [Artifacts produced]
## Acceptance Criteria
1. [Specific, measurable criterion]
2. [Another verifiable requirement]
## Verification Steps
1. [How to verify criterion 1]
2. [How to verify criterion 2]
## CoVe Checks (ONLY if accuracy-risk is medium or high)
- Key claims to verify:
- [Claim 1]
- Verification questions:
1. [Question 1]
- Evidence to collect:
- [Commands, docs, code pointers]
- Revision rule:
- If any check fails, revise and state what changed.
Before returning the task prompt, you MUST lint it using the existing rules:
If any lint check fails, revise the task prompt and re-lint.
development
When an application needs to store config, data, cache, or state files. When designing where user-specific files should live. When code writes to ~/.appname or hardcoded home paths. When implementing cross-platform file storage with platformdirs.
testing
Enforce mandatory pre-action verification checkpoints to prevent pattern-matching from overriding explicit reasoning. Use this skill when about to execute implementation actions (Bash, Write, Edit) to verify hypothesis-action alignment. Blocks execution when hypothesis unverified or action targets different system than hypothesis identified. Critical for preventing cognitive dissonance where correct diagnosis leads to wrong implementation.
tools
Reference guide for the Twelve-Factor App methodology — 15 principles (12 original + 3 modern extensions) for building portable, resilient, cloud-native applications. Use when evaluating application architecture, designing cloud-native services, reviewing codebases for methodology compliance, advising on configuration, scaling, observability, security, and deployment patterns. Incorporates the 2025 open-source community evolution and cloud-native reinterpretations of each factor.
tools
Converts user-facing documentation (how-to guides, tutorials, API references, examples) in any format — Markdown, PDF, DOCX, PPTX, XLSX, AsciiDoc, RST, HTML, Jupyter notebooks, man pages, TOML/YAML/JSON configs, and plain text — into Claude Code skill directories with SKILL.md plus thematically grouped references/*.md files. Use when given a docs directory or mixed-format documentation to transform into an AI skill. Uses MCP file-reader server for binary formats.