Personal collection of CLI tools that double as AI agent skills. Each skill is a standalone Python CLI paired with a SKILL.md manifest for agent discovery.
Skills work from the terminal for humans and from agents (Claude Code, Copilot, etc.) via SKILL.md instructions.
Every skill is a real CLI first. There are no agent-only APIs or hidden interfaces — if an agent can do it, you can do it from your terminal. The SKILL.md manifest just teaches agents which commands exist and when to use them.
This means skills are testable, composable, and useful even without an AI agent. The agent is a caller, not a requirement.
| Skill | Version | Status | Description |
|---|---|---|---|
| chronicler | 0.1.0 | Active | Research historical events from local history sources |
| clipper | 0.1.0 | Active | Copy content to the system clipboard without whitespace noise |
| courier | 0.1.0 | Active | Telegram-based messaging for Claude workflows |
| futzer | 0.1.0 | Experimental | Opinionated config generator you own and understand |
| locker | 0.1.0 | Active | Deterministic secret storage for guppi skills |
| paper | 0.1.0 | Experimental | Analyze academic papers using the Feynman Technique |
| shooter | 0.1.0 | Experimental | Screenshot manager — set preferences and manage screen captures |
| snapper | 0.1.0 | Active | CDP browser screenshots for capturing authenticated web pages |
| spiker | 0.3.0 | Active | Manage experimental spike projects in a centralized, searchable location |
| surfer | 0.1.0 | Experimental | Chrome browser automation via AppleScript JavaScript execution |
| tracker | 0.2.0 | Active | Cross-project task and idea tracker built on beads |
Install any skill with guppi-cli:
guppi skills install <name> --source guppi-skillsOr install directly with uv:
cd <skill-name>/
uv tool install .After installing, each skill is available as guppi-<name>:
guppi-chronicler search "github" --since yesterday
guppi-clipper copy myfile.txt
guppi-courier receive
guppi-locker get courier bot-token
guppi-paper prompt https://arxiv.org/abs/2301.00001
guppi-snapper capture https://example.com
guppi-spiker new redis-caching
guppi-tracker add "Try out DuckDB for analytics"Every skill also has a skill subcommand for agent integration:
guppi-<name> skill show # Display SKILL.md manifest
guppi-<name> skill install # Register with guppi-cli- Python 3.11+
- uv for package management
cd <skill-name>/
uv sync # Install dependencies
uv run guppi-<name> --help # Run locally
uv run pytest # Run testsEach skill has three docs, each for a different audience:
| File | For | Purpose |
|---|---|---|
README.md |
Users | What it does, how to use it, examples |
SKILL.md |
Agents | Instructions Claude follows when invoked |
docs/design/ |
Developers | Architecture and feature planning |
Browse any skill's directory on GitHub to see its README rendered automatically.
See CLAUDE.md for conventions, directory structure, and templates. Skills follow the Agent Skills open standard.
Each skill is versioned and tagged independently. See RELEASE.md for details.
git tag -a <name>/vX.Y.Z -m "<name> version X.Y.Z"
git push origin <name>/vX.Y.ZThis is a personal automation toolkit. Use at your own risk. No warranties, no support guarantees.