← Back to Skills Marketplace

ia-file-todos

Name: ia-file-todos
Author: iliaal

by Ilia Alshanetsky · GitHub ↗ · v3.0.4 · MIT-0

cross-platform ✓ Security Clean

333

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install compound-eng-file-todos

Description

File-based todo and task tracking in the todos/ directory. Use when creating, triaging, listing, or managing todo files, tracking work items, managing the ba...

README (SKILL.md)

File-based todo tracking

File naming convention

{issue_id}-{status}-{priority}-{description}.md

issue_id: Sequential number (001, 002, 003...) -- never reused
status: pending (needs triage), ready (approved), complete (done)
priority: p1 (critical), p2 (important), p3 (nice-to-have)
description: kebab-case, brief description

Examples: 001-pending-p1-mailer-test.md, 002-ready-p1-fix-n-plus-1.md, 005-complete-p2-refactor-csv.md

File Structure

Use todo-template.md as a starting point. YAML frontmatter:

---
status: ready              # pending | ready | complete
priority: p1               # p1 | p2 | p3
issue_id: "002"
tags: [typescript, performance, database]
dependencies: ["001"]      # Issue IDs this is blocked by
---

Required sections: Problem Statement, Findings, Proposed Solutions, Recommended Action, Acceptance Criteria, Work Log

Optional sections: Technical Details, Resources, Notes

Key Distinctions

File-todos system (this skill): Markdown files in todos/ directory for development/project tracking. Used by humans and agents.

Application Todo model: Database model for user-facing task management. Different from this file-based system.

TodoWrite tool: In-memory task tracking during agent sessions. Temporary, not persisted to disk.

References

workflows.md - Creating, triaging, dependencies, work logs, completing todos, integration table
quick-reference.md - Bash commands for finding work, dependencies, searching
todo-template.md - Template for new todo files

Usage Guidance

This skill is an instruction-only helper for local, file-based todo tracking. Before installing, confirm you’re comfortable with an agent reading and writing files under a todos/ directory in the repo/workspace where the skill will run. Do not store secrets or sensitive data in those markdown files. Note the skill references shell commands (grep, ls, mv, cp) and human-facing integrations like gh CLI and slash commands in docs — these are integration notes, not automatic network calls. Because disable-model-invocation is set, the skill won’t autonomously invoke the model, reducing risk. If you want additional safety, restrict the workspace to a repository that does not contain secrets and review any todo files the agent will edit.

Capability Analysis

Type: OpenClaw Skill Name: compound-eng-file-todos Version: 3.0.4 The skill bundle provides a structured framework for managing file-based todo lists in a dedicated directory. All instructions and shell commands (found in SKILL.md and references/quick-reference.md) are limited to local file operations such as grep, ls, and awk for task tracking. The SPEC.md file explicitly includes security guidelines prohibiting the storage of secrets or machine-specific paths, and no evidence of malicious intent, data exfiltration, or unauthorized execution was found.

Capability Tags

cryptocan-make-purchases

Capability Assessment

✓ Purpose & Capability

Name/description match the included content: all files, templates, and commands relate to creating, triaging, listing, and managing markdown todo files in a todos/ directory. No unrelated binaries, credentials, or remote endpoints are required.

✓ Instruction Scope

Runtime instructions and bundled references only describe filesystem operations against a local todos/ directory (copying the template, grep/ls commands, renaming files, editing frontmatter). There are no instructions to read unrelated system files, access environment secrets, or transmit data to external endpoints. Mentions of slash commands or gh CLI are descriptive/integration notes, not active remote endpoints in the SKILL.md.

✓ Install Mechanism

No install spec or packaged code — instruction-only skill. Nothing is downloaded or written to disk by an installer, minimizing installation risk.

✓ Credentials

The skill declares no required environment variables, credentials, or config paths. The instructions only operate on local markdown files under todos/, which is proportionate to its stated scope.

✓ Persistence & Privilege

Flags: always is false and disable-model-invocation is true (skill will not invoke the model autonomously), and the skill does not request system-wide or other-skills configuration changes. It does not request persistent elevated privileges.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install compound-eng-file-todos
After installation, invoke the skill by name or use /compound-eng-file-todos
Provide required inputs per the skill's parameter spec and get structured output

Version History

v3.0.4

v3.0.3

v3.0.2

v3.0.1

v3.0.0

v2.56.1

v2.56.0

v2.55.1

v2.55.0

v2.53.2

v2.53.0

Metadata

Slug compound-eng-file-todos

Version 3.0.4

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 11

Frequently Asked Questions

What is ia-file-todos?

File-based todo and task tracking in the todos/ directory. Use when creating, triaging, listing, or managing todo files, tracking work items, managing the ba... It is an AI Agent Skill for Claude Code / OpenClaw, with 333 downloads so far.

How do I install ia-file-todos?

Run "/install compound-eng-file-todos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ia-file-todos free?

Yes, ia-file-todos is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ia-file-todos support?

ia-file-todos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ia-file-todos?

It is built and maintained by Ilia Alshanetsky (@iliaal); the current version is v3.0.4.

More Skills