theodoread/agent-skills

1

session-harvest Use when invoked explicitly as /session-harvest, or when the user asks what's worth saving before compacting/ending a…

theodoread/agent-skills

40

2

plan-docs Use when capturing an idea, drafting a design, or tracking work-in-progress in a repo's plans/ directory — creating o…

theodoread/agent-skills

38

3

invoke-task-conventions Use when adding, renaming, or reviewing an invoke task in a tasks.py or tasks/ package — deciding what to call `inv <…

theodoread/agent-skills

36

4

db-defaults Use when adding local data persistence to a Python project — caching, relational storage (simple, complex/OLTP, or an…

theodoread/agent-skills

35

5

polite-mcp-conventions Use when working in one of the *-polite-mcp personal automation repos (olx-polite-mcp, emag-polite-mcp, altex-polite-…

theodoread/agent-skills

35

6

python-conventions Use when writing, reviewing or refactoring Python and you want one settled answer rather than an evaluation — choosin…

theodoread/agent-skills

35

7

research-library Use when working with, adding to, or updating the shared cross-project research library at $RESEARCH_HOME (vendor rep…

theodoread/agent-skills

35

8

session-bash-audit Use when asked to audit, measure, or re-check how agent sessions are using the Bash tool — command chaining (&&, ;, |…

theodoread/agent-skills

35

9

skill-authoring Use when writing a new Agent Skill, editing an existing SKILL.md, or getting a skill change actually deployed — where…

theodoread/agent-skills

35

10

mcp-server-shipping Use when building, installing or registering a personal MCP server — adding its `[project.scripts]` entry point, inst…

theodoread/agent-skills

34

11

skill-fitness Use when asking whether installed skills are actually working — why a skill never fires or fires on the wrong request…

theodoread/agent-skills

24

12

mcp-python-conventions Use when writing the Python inside an MCP server and deciding how it should behave — where log output may go when std…

theodoread/agent-skills

20

13

python-testing-conventions Use when writing or restructuring Python tests — deciding how much duplication a test should carry before it stops be…

theodoread/agent-skills

20

14

python-refactor-audit Use when an existing Python module has grown and the question is how to restructure it safely, not what to write — au…

theodoread/agent-skills

15

15

mcp-skill-shipping Use when developing or distributing a personal MCP server or Agent Skill repo (e.g. the `*-polite-mcp` family, `produ…

theodoread/agent-skills

2