Promote todo.txt to OpenSpec
Group selected todo.txt items into privacy-safe OpenSpec transformations and hold every proposed change for approval.
Use when: Group and transform selected todo.txt items into approval-gated OpenSpec changes while preserving privacy and avoiding one-to-one promotion assumptions.
Install only this skill
Section titled “Install only this skill”arcantry skills link promote-todo-to-openspec --scope userThis links only promote-todo-to-openspec to the standard user location, ~/.agents/skills. Use --scope repo for one repository, or add --compat claude when that optional alias is needed.
Compatibility
Section titled “Compatibility”Source kinds: openspec, todo-txt.
What it helps with
Section titled “What it helps with”- Classify todo.txt items before deciding whether they belong in OpenSpec.
- Propose zero-to-many and many-to-many transformations without losing operational or private work.
History
Section titled “History”- 2026-09-11 - Preserve each todo queue’s established vocabulary during capture: Arcantry previews the exact task line, reuses compatible local conventions and asks before inventing or omitting meaningful optional metadata.
- 2026-08-18 - Coordinate project knowledge and agent workflows with Arcantry: Arcantry provides local-first project configuration, safe repository adoption, a portable catalog of focused agent skills, and one documented workflow for maintaining project intent, release meaning, task intake, verification, and audience-safe content.
Examples
Section titled “Examples”Review a mixed todo queue
Section titled “Review a mixed todo queue”Prompt
Use the promote-todo-to-openspec skill to classify this todo.txt and propose separate transformations for my approval before changing files.
Expected outcome
Every item is accounted for while operational, unclear, private, and sensitive work remains outside shared specifications.
Consolidate overlapping product intent
Section titled “Consolidate overlapping product intent”Prompt
Use the promote-todo-to-openspec skill to map these overlapping todo.txt entries into existing or new OpenSpec changes without assuming one-to-one promotion.
Expected outcome
A coverage ledger presents merge, split, relocation, and preservation choices that can be accepted independently.