How do I install the Lists skill?

Run npx skillmds@latest add eddmann/lists 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 Lists safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lists?

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 Lists free to use?

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

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

Lists by eddmann — Agent Skill

Name: Lists
Author: eddmann

Lists

General-purpose lists — shopping, questions for appointments, packing lists, etc. Use when the user wants to create a list, add items, "shopping list", "questions for appointments", "what's on my list", or manages grouped items around a theme or event.

eddmann b858e7e 10 files · 11.2 KB Updated Sep 17, 2026 27 repo stars

File contents

Lists Skill

Themed lists with optional due dates and cron reminders. SQLite, pure Python stdlib.

Scripts in workspace/skills/lists/scripts/, database at workspace/skills/lists/db/lists.sqlite.

First Run

uv run workspace/skills/lists/scripts/init_db.py

Create a List

echo '{"name": "Appointment questions", "due": "2026-02-25", "notes": "10am appointment"}' | uv run workspace/skills/lists/scripts/create.py
echo '{"name": "Shopping"}' | uv run workspace/skills/lists/scripts/create.py

Add Items

echo '{"list_id": 1, "text": "Ask about pricing"}' | uv run workspace/skills/lists/scripts/add.py
echo '{"list_id": 1, "items": ["Check availability", "Confirm address", "What to bring"]}' | uv run workspace/skills/lists/scripts/add.py

Show a List

uv run workspace/skills/lists/scripts/show.py 1

Shows all items sorted: unchecked first, then checked. Includes total and unchecked counts.

Check Off Items

uv run workspace/skills/lists/scripts/check.py 1 2 3          # check items by ID
echo '{"ids": [1, 2], "uncheck": true}' | uv run workspace/skills/lists/scripts/check.py  # uncheck

Remove an Item

uv run workspace/skills/lists/scripts/remove.py 1

Show All Lists

uv run workspace/skills/lists/scripts/lists.py                # active only
uv run workspace/skills/lists/scripts/lists.py all             # including archived

Check What's Due

uv run workspace/skills/lists/scripts/due.py

Returns active lists due today or tomorrow with all items. Use in cron for reminders.

Archive a List

uv run workspace/skills/lists/scripts/archive.py 1

Hides from active view. Data preserved.

Reminders

For any reminders about due lists, use the reminders skill. The due.py script is available for on-demand checks ("what's coming up?").

Quick Reference — What to Say

"Create an appointment questions list for tomorrow" → create.py
"Add to appointment list: ask about pricing" → add.py
"Show appointment list" → show.py
"Check that off" → check.py
"What lists do I have?" → lists.py
"What's coming up?" → due.py
"Done with that list" → archive.py
"Remind me about the shopping list tomorrow morning" → use reminders skill

---name: listsdescription: General-purpose lists — shopping, questions for appointments, packing lists, etc. Use when the user wants to create a list, add items, "shopping list", "questions for appointments", "what's on my list", or manages grouped items around a theme or event.---# Lists SkillThemed lists with optional due dates and cron reminders. SQLite, pure Python stdlib.Scripts in `workspace/skills/lists/scripts/`, database at `workspace/skills/lists/db/lists.sqlite`.## First Run```bashuv run workspace/skills/lists/scripts/init_db.py```## Create a List```bashecho '{"name": "Appointment questions", "due": "2026-02-25", "notes": "10am appointment"}' | uv run workspace/skills/lists/scripts/create.pyecho '{"name": "Shopping"}' | uv run workspace/skills/lists/scripts/create.py```## Add Items```bashecho '{"list_id": 1, "text": "Ask about pricing"}' | uv run workspace/skills/lists/scripts/add.pyecho '{"list_id": 1, "items": ["Check availability", "Confirm address", "What to bring"]}' | uv run workspace/skills/lists/scripts/add.py```## Show a List```bashuv run workspace/skills/lists/scripts/show.py 1```Shows all items sorted: unchecked first, then checked. Includes total and unchecked counts.## Check Off Items```bashuv run workspace/skills/lists/scripts/check.py 1 2 3 # check items by IDecho '{"ids": [1, 2], "uncheck": true}' | uv run workspace/skills/lists/scripts/check.py # uncheck```## Remove an Item```bashuv run workspace/skills/lists/scripts/remove.py 1```## Show All Lists```bashuv run workspace/skills/lists/scripts/lists.py # active onlyuv run workspace/skills/lists/scripts/lists.py all # including archived```## Check What's Due```bashuv run workspace/skills/lists/scripts/due.py```Returns active lists due today or tomorrow with all items. Use in cron for reminders.## Archive a List```bashuv run workspace/skills/lists/scripts/archive.py 1```Hides from active view. Data preserved.## RemindersFor any reminders about due lists, use the **reminders skill**. The `due.py` script is available for on-demand checks ("what's coming up?").## Quick Reference — What to Say- "Create an appointment questions list for tomorrow" → `create.py`- "Add to appointment list: ask about pricing" → `add.py`- "Show appointment list" → `show.py`- "Check that off" → `check.py`- "What lists do I have?" → `lists.py`- "What's coming up?" → `due.py`- "Done with that list" → `archive.py`- "Remind me about the shopping list tomorrow morning" → use reminders skill

Frequently asked questions