Agent skill
file-todos
Manage file-based todo tracking in the todos/ directory
Install this agent skill to your Project
npx add-skill https://github.com/salavender/antigravity-compound-engineering-plugin/tree/main/skills/file-todos
SKILL.md
File-Based Todo Tracking
Provides workflows for creating, managing, and completing todos stored as markdown files.
Overview
The todos/ directory contains markdown files with YAML frontmatter for tracking work items.
File Naming Convention
{issue_id}-{status}-{priority}-{description}.md
Examples:
001-pending-p1-security-fix.md
002-ready-p2-performance-opt.md
003-complete-p3-cleanup.md
Status Lifecycle
pending → ready → complete
↓
(deleted if skipped)
What do you want to do?
- Create a todo → See "Creating Todos" below
- Triage pending items → Use
/triage - Work on todos → Use
/resolve_todo - Check dependencies → See "Dependency Management" below
Instrumentation
# Log usage when using this skill
./scripts/log-skill.sh "file-todos" "manual" "$$"
Creating Todos
# Get next ID
next_id=$(ls todos/*.md 2>/dev/null | grep -o '[0-9]\+' | sort -n | tail -1 | awk '{printf "%03d", $1+1}')
[ -z "$next_id" ] && next_id="001"
# Copy template
cp todos/todo-template.md todos/${next_id}-pending-{priority}-{description}.md
Dependency Management
# In YAML frontmatter
dependencies: ["001", "002"] # Blocked by these issues
dependencies: [] # No blockers
Check blockers:
grep "dependencies:" todos/{file}.md
Quick Commands
# List by status
ls todos/*-pending-*.md
ls todos/*-ready-*.md
ls todos/*-complete-*.md
# List by priority
ls todos/*-p1-*.md
# Count by status
for s in pending ready complete; do
echo "$s: $(ls todos/*-$s-*.md 2>/dev/null | wc -l)"
done
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
session-resume
Resume context from previous session
compound-docs
Document solved problems for knowledge persistence
standard-security-auth
Security & Authentication Specialist - Expert in JWT, cookie-based auth, MFA, and generic security patterns
debug
Systematic debugging with structured reproduction and root cause analysis.
mobile
Expertise in mobile responsiveness, specifically table patterns and standard UI component styling.
react-hooks
Resolves React hook violations (rules of hooks, useEffect dependencies, hook ordering).
Didn't find tool you were looking for?