How do I install the Clawkeeper skill?

Run npx skillmds@latest add dvcrn/clawkeeper in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Clawkeeper safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clawkeeper?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clawkeeper free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clawkeeper?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clawkeeper by dvcrn — Agent Skill

Name: Clawkeeper
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

File contents

ClawKeeper CLI

Manage the user's tasks and habits via the ClawKeeper CLI. All data is stored as markdown at the path set by CLAWKEEPER_DIR (defaults to ~/.clawkeeper/).

clawkeeper <entity> <command> [--flags]

If CLAWKEEPER_DIR is set in your environment, the CLI reads and writes data there. This allows multiple agents to share the same task list.

Tasks

clawkeeper task list
clawkeeper task add --text "Buy groceries"
clawkeeper task add --text "Buy groceries" --due-date 2026-03-15
clawkeeper task add-subtask --parent-text "Buy groceries" --text "Milk"
clawkeeper task complete --id <id>
clawkeeper task complete --text "Buy groceries"
clawkeeper task uncomplete --id <id>
clawkeeper task edit --text "Old name" --new-text "New name"
clawkeeper task edit --text "Old name" --due-date 2026-04-01
clawkeeper task set-due-date --text "Buy groceries" --due-date 2026-03-15
clawkeeper task set-due-date --text "Buy groceries" --due-date none
clawkeeper task delete --text "Buy groceries"
clawkeeper task add-note --text "Buy groceries" --note "Check prices first"
clawkeeper task edit-note --text "Buy groceries" --note "Check prices first" --new-note "Compare at two stores"
clawkeeper task delete-note --text "Buy groceries" --note "Check prices first"

Habits

clawkeeper habit list
clawkeeper habit add --text "Meditate" --interval 24
clawkeeper habit edit --text "Meditate" --new-text "Morning meditation" --interval 12
clawkeeper habit delete --text "Meditate"
clawkeeper habit complete --text "Meditate"
clawkeeper habit add-note --text "Meditate" --note "Felt calm today"
clawkeeper habit edit-note --text "Meditate" --note "Felt calm today" --new-note "Felt calm, 10 min session"
clawkeeper habit delete-note --text "Meditate" --note "Felt calm today"

State

clawkeeper state show

Proactive Checks (Heartbeat)

When running periodic checks, use clawkeeper state show to review the user's habits and tasks:

Missed habits: If a habit hasn't been completed for more than 2x its interval, ask about it gently. People forget — a nudge helps more than a lecture.
Building streaks: When a habit's completion count is climbing, acknowledge the momentum briefly.
Recent notes: If the user added reflections or notes recently, reference them for continuity. It shows you're paying attention.
Stale tasks: Tasks sitting open for a long time might need to be broken down, re-prioritized, or dropped.

Tone: supportive collaborator, not drill sergeant. If nothing needs attention, reply HEARTBEAT_OK.

Notes

All commands return JSON: {"ok": true, "data": ...} on success, {"ok": false, "error": "..."} on failure.
IDs are stable across invocations. Use --id for precise lookups or --text for fuzzy substring matching.
When adding a task, the response includes the new task's id for subsequent operations.

---name: clawkeeperdescription: Tasks and habits that live in a plain markdown file on your machine. Free, private, and claw-native.---# ClawKeeper CLIManage the user's tasks and habits via the ClawKeeper CLI. All data is stored as markdown at the path set by `CLAWKEEPER_DIR` (defaults to `~/.clawkeeper/`).```bashclawkeeper <entity> <command> [--flags]```If `CLAWKEEPER_DIR` is set in your environment, the CLI reads and writes data there. This allows multiple agents to share the same task list.## Tasks```bashclawkeeper task listclawkeeper task add --text "Buy groceries"clawkeeper task add --text "Buy groceries" --due-date 2026-03-15clawkeeper task add-subtask --parent-text "Buy groceries" --text "Milk"clawkeeper task complete --id <id>clawkeeper task complete --text "Buy groceries"clawkeeper task uncomplete --id <id>clawkeeper task edit --text "Old name" --new-text "New name"clawkeeper task edit --text "Old name" --due-date 2026-04-01clawkeeper task set-due-date --text "Buy groceries" --due-date 2026-03-15clawkeeper task set-due-date --text "Buy groceries" --due-date noneclawkeeper task delete --text "Buy groceries"clawkeeper task add-note --text "Buy groceries" --note "Check prices first"clawkeeper task edit-note --text "Buy groceries" --note "Check prices first" --new-note "Compare at two stores"clawkeeper task delete-note --text "Buy groceries" --note "Check prices first"```## Habits```bashclawkeeper habit listclawkeeper habit add --text "Meditate" --interval 24clawkeeper habit edit --text "Meditate" --new-text "Morning meditation" --interval 12clawkeeper habit delete --text "Meditate"clawkeeper habit complete --text "Meditate"clawkeeper habit add-note --text "Meditate" --note "Felt calm today"clawkeeper habit edit-note --text "Meditate" --note "Felt calm today" --new-note "Felt calm, 10 min session"clawkeeper habit delete-note --text "Meditate" --note "Felt calm today"```## State```bashclawkeeper state show```## Proactive Checks (Heartbeat)When running periodic checks, use `clawkeeper state show` to review the user's habits and tasks:- **Missed habits**: If a habit hasn't been completed for more than 2x its interval, ask about it gently. People forget — a nudge helps more than a lecture.- **Building streaks**: When a habit's completion count is climbing, acknowledge the momentum briefly.- **Recent notes**: If the user added reflections or notes recently, reference them for continuity. It shows you're paying attention.- **Stale tasks**: Tasks sitting open for a long time might need to be broken down, re-prioritized, or dropped.Tone: supportive collaborator, not drill sergeant. If nothing needs attention, reply `HEARTBEAT_OK`.## Notes- All commands return JSON: `{"ok": true, "data": ...}` on success, `{"ok": false, "error": "..."}` on failure.- IDs are stable across invocations. Use `--id` for precise lookups or `--text` for fuzzy substring matching.- When adding a task, the response includes the new task's `id` for subsequent operations.

Frequently asked questions

Clawkeeper