# tools ofthemachine

> Level-0 tools -- single-file fraglets that run in pinned containers via fragletc -- organised into packs, one directory each, published as one Agent Skill per pack. Each pack below is one Agent Skill: a SKILL.md listing its tools, with the tools beside it. A tool is a single file that runs in a pinned container via fragletc (https://github.com/ofthemachine/fraglet; install with `curl -fsSL https://raw.githubusercontent.com/ofthemachine/fraglet/main/install.sh | sh && fragletc version`) and Docker; `<tool> --fraglet-help` prints its contract, `--receipt` records a run. The whole catalog is also published as tools.tar.gz beside this file.

## Install

```sh
curl -fsSL https://raw.githubusercontent.com/ofthemachine/fraglet/main/install.sh | sh && fragletc version
curl -fsSL https://tools.ofthemachine.com/<pack>.tar.gz | tar xz -C <skills dir>   # -> <skills dir>/<pack>/SKILL.md, wherever your harness loads skills from
sha256sum <skills dir>/<pack>/*   # each tool's must equal its procedure_hash in manifest.json
```

## Packs

- [astro](astro/SKILL.md): The sky over a place and date -- moon phase, sunrise and sunset -- computed, not fetched. Tools: daylight, moon-phase, sun-times.
- [catalog](catalog/SKILL.md): Build, check, publish, and depend on a catalog of fraglet tools -- compile packs into skills, validate the result, render its website, and vendor pinned tools into another repository. Tools: compile, site, validate, vendor.
- [chart](chart/SKILL.md): Generate standalone SVG vector charts (bar, line, scatter, pie) from tabular data. Tools: plot.
- [cloudflare](cloudflare/SKILL.md): What a Cloudflare account is using, read with a read-only API token -- today's Worker requests against the daily quota, and where they come from; its traffic over 24 minutes, hours and days, charted and diagnosed. Tools: latency, traffic, usage.
- [code](code/SKILL.md): Source-code structure and analysis -- symbol outlines across 140+ languages. Tools: symbol-outline.
- [data](data/SKILL.md): Slice, filter, and reshape structured data with jq and SQL. Tools: jq, sql.
- [diagram](diagram/SKILL.md): Render Graphviz DOT with any layout engine. Tools: graphviz.
- [doc](doc/SKILL.md): Render Markdown, bundles, and LaTeX to PDF; extract text and render pages from PDF and Office files. Tools: extract-text, latex-to-pdf, markdown-to-pdf, pdf-to-images.
- [github](github/SKILL.md): GitHub issues and events as data for issue-driven workflows -- the fields of an issue form, and whether an event's sender is an approver. Tools: check-approver, read-issue-form.
- [home-automation](home-automation/SKILL.md): Control and query home-automation devices on the LAN -- starting with Roku's ECP remote-control API. Tools: hue-lights, hue-set, roku-apps, roku-launch, roku-play, roku-press, roku-status, roku-type.
- [image](image/SKILL.md): Resize, crop, convert, compress, and diff raster images. Tools: chyron, diff, qr, transform.
- [llm](llm/SKILL.md): Text from language models (one provider per tool, the API key declared as a secret and the provider's host fixed; llm/local for a model server on this machine, no key) and llm/prompt, which composes what they read. Tools: cohere, local, prompt.
- [math](math/SKILL.md): Small pure computations -- primality, Fibonacci. Tools: fibonacci, is-prime.
- [meme](meme/SKILL.md): Find meme templates and caption them, with meme-cli. Tools: caption, catalog, list, templates.
- [net](net/SKILL.md): The host's place on the network -- its public IP address and where an IP address is. Tools: ip-location, public-ip.
- [news](news/SKILL.md): Headlines from any RSS or Atom feed, BBC world news by default. Tools: headlines.
- [package](package/SKILL.md): Facts about published software packages -- versions, release dates, licenses, and dependencies from PyPI, npm, crates.io, and Docker Hub. Tools: metadata.
- [poem](poem/SKILL.md): Poems about any subject -- the prompts a language model (llm/*) writes one from, in a chosen form and voice. Tools: prompt.
- [receipt](receipt/SKILL.md): Work with fragletc run receipts -- attest one against the script that ran, or typeset a bundle of them as a ledger that links each run's inputs to earlier outputs. Tools: attest, ledger.
- [sheet](sheet/SKILL.md): Inspect, summarize, and convert spreadsheet workbooks (Excel XLSX, ODS). Tools: convert, inspect.
- [token](token/SKILL.md): Count and chunk text by LLM token budget (OpenAI tiktoken encodings). Tools: chunk, count.
- [trivia](trivia/SKILL.md): Advice, cat facts, jokes, and on-this-day anniversaries from free public APIs. Tools: advice, cat-fact, joke, on-this-day.
- [weather](weather/SKILL.md): Live current conditions and three-day forecasts for any place. Tools: current, forecast, frog.
- [web](web/SKILL.md): Search the web and turn a page into Markdown, PDF, a screenshot, or its metadata; find an existing archived snapshot. Tools: archive-snapshot, page-metadata, page-to-markdown, page-to-pdf, screenshot, search, wiki-summary.
- [words](words/SKILL.md): Text games and transforms -- palindromes, ROT13, Wordle solving. Tools: is-palindrome, rot13, solve-wordle.

## Optional

- [llms-full.txt](llms-full.txt): every pack's SKILL.md, concatenated
- [manifest.json](manifest.json): every tool's contract and procedure_hash, as JSON
- [CONTRIBUTING.md](CONTRIBUTING.md): how to write a new tool -- clone a sibling, header grammar, verification protocol
- [.claude-plugin/marketplace.json](.claude-plugin/marketplace.json): the packs as a Claude Code plugin marketplace
- [okf/index.md](okf/index.md): the same catalog as an Open Knowledge Format bundle
