task-spec
luanmorenommaciel/task-spec
Task-Spec is an open, self-verifying unit-of-work format that uses markdown, YAML frontmatter, and runnable bash commands to define and execute tasks. It includes a bash toolchain for authoring, validating, and accepting tasks, ensuring consistency and traceability across different environments.
3 8MITUpdated 2026-08-22
Overview
Task-Spec provides a standardized, executable format for defining and verifying tasks in software development. It supports versioned specifications, conformance testing, and portable handoffs between agents and systems. The toolchain includes a CLI for managing tasks, a conformance suite for validation, and a self-test framework to ensure correctness. It is designed to be used in any repository that requires a clear, auditable contract between intent and execution.
Capabilities
- ▸Define and execute atomic tasks with YAML and markdown
- ▸Validate tasks against a conformance suite
- ▸Support versioned specifications and format changes
- ▸Provide portable handoffs between agents
- ▸Ensure traceability and auditability of task execution
Best for
Used for defining and verifying atomic tasks in software development, ensuring consistent execution across different agents and systems. It is ideal for teams that require traceable, auditable workflows, such as in CI/CD pipelines, code reviews, and task delegation.
Works with
CodexCursorOpenCodeClaude Code
Security considerations
The Task-Spec engine does not handle credentials, private keys, or exfiltrate data to external endpoints. It relies on local execution and Git for version control, ensuring that no sensitive information is transmitted or stored externally.
Categories
Summary and analysis are original content generated by AI Skills Rank. The skill's source text is not reproduced here — view it on the linked repository.