Tinyhat
See which skills are part of your workflow — and which ones you may be missing.
Tinyhat is a small Claude Code plugin that looks at your recent usage and turns it into a report.
I built it because I wanted a more honest view of my setup: what I was actually using, what was just sitting there installed, and what kinds of work kept coming up without a fitting skill.
Instead of guessing what skills you need, you can start from your actual workflow.
That usually leads to three useful actions:
- improve the skills you already rely on
- remove unused skills
- create the skills you seem to be missing
Everything runs locally. No hooks, no daemons, no network calls.
A local report built from your recent Claude Code usage, showing which skills seem active, which look unused, and where you may be missing a skill.
Why "Tinyhat"?
I kept coming back to the way people switch roles: "put on your marketing hat," "put on your ops hat."
This project started from wondering whether agents might work that way too: different hats, different skills, different ways of working.
Tinyhat is just a small tool to help make those skills easier to see.
Install
Inside Claude Code, add the Tinyloop marketplace and install the plugin from it:
/plugin marketplace add tinyhat-ai/tinyhat
/plugin install tinyhat@tinyloop
/reload-plugins
The first line registers Tinyloop's marketplace (this repo doubles as its own marketplace). The second installs the tinyhat plugin from it. After this, /plugin marketplace update tinyloop pulls newer versions.
If /plugin update tinyhat@tinyloop appears to leave Tinyhat on old
code, reinstall cleanly:
/plugin remove tinyhat@tinyloop
/plugin install tinyhat@tinyloop
/reload-plugins
Requires Python 3.9+ on your PATH (pre-installed on macOS and most Linux).
Usage
Ask in plain English or use a slash command:
- Produce a report: "Audit my skills." ·
/tinyhat:audit
- Re-open the last report: "Show my latest skill audit." ·
/tinyhat:open
- Browse history: "Show my skill-audit history." ·
/tinyhat:history
- Manage the daily routine: "Turn off tinyhat's daily run." ·
/tinyhat:routine status|on|off|where|clear
Tinyhat writes under Claude Code's per-plugin data directory. For a
marketplace install of tinyhat@tinyloop, the latest HTML typically
lands at ~/.claude/plugins/data/tinyhat-tinyloop/latest/report.html.
If you're upgrading from an older Tinyhat, the next write-capable run
automatically migrates data from the legacy ~/.claude/tinyhat/
directory.
For every flow, trigger, and sub-command, see
docs/user-flows.md.
Documentation
Deeper docs live in docs/:
Contributing
Fork, branch (feat/..., fix/..., docs/..., chore/...), open a PR. Use Conventional Commits for the subject. We squash-merge onto a linear main.
Full workflow: CONTRIBUTING.md.
Community
License
MIT. See LICENSE.
