Two CLIs, one skill wrapper. radarr-cli manages movies (list, lookup,
calendar, collections), sonarr-cli manages TV series (list, lookup,
episodes, calendar, wanted). Separate API keys and server URLs per app.
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed flags.
Signed-off-by: Jasper <magnus@groktop.us>
CLI wrapper for the public Open Library API (no API key required).
Commands: search books, search-authors, author details, work details,
ISBN lookup.
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
emit() dual-output, structured logging, pre-parsed global flags.
Signed-off-by: Jasper <magnus@groktop.us>
CLI wrapper for TMDb API v3. Commands: movie search/discover/upcoming,
tv search/discover, trending, genre list, certification list.
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via TMDB_ACCESS_TOKEN or TMDB_API_KEY.
Signed-off-by: Jasper <magnus@groktop.us>
CLI wrapper for the Forgejo/Gitea REST API v1. Commands:
- me: current user profile
- repos: list user repositories
- search: search repositories by query
- issues: list issues in a repo (filters out PRs)
- view: view issue or PR details with body, labels, milestone
- prs: list pull requests with head/base branch info
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via FORGEJO_TOKEN (token auth header).
Signed-off-by: Jasper <magnus@groktop.us>
CLI wrapper for the Atlassian Confluence Cloud REST API. Commands:
- me: current user profile
- spaces: list spaces with keys and IDs
- pages: list pages by space with version info
- view: full page content with HTML body extraction
- search: CQL search with result excerpts
- create: create pages with HTML body and parent support
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via CONFLUENCE_EMAIL + CONFLUENCE_API_TOKEN.
Handles v2 API for CRUD, rest API for search and user.
Signed-off-by: Jasper <magnus@groktop.us>
CLI wrapper for the Atlassian Jira Cloud REST API v3. Commands:
- me: current user profile
- list: search issues with JQL or --project shortcut
- view: full issue details with ADF plain-text extraction
- projects: list all accessible projects
- create: create issues with type and priority
- comment: add comments to issues
- transition: change issue status by name or ID
All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via JIRA_EMAIL + JIRA_API_TOKEN (Basic Auth).
Signed-off-by: Jasper <magnus@groktop.us>
Each harness's skill directory path and loading mechanism is now
sourced from agentskills.io/clients, which maintains the canonical
list of compatible frameworks with verified setup guide URLs.
Only Hermes Agent retains inline instructions since we maintain it.
Signed-off-by: Jasper <magnus@groktop.us>
Removed fabricated Codex skill directory path. Replaced with a
reference to official Codex documentation since the actual path
could not be confirmed.
Signed-off-by: Jasper <magnus@groktop.us>
README.md: curated skill index with descriptions for all 6 skills,
installation sections for Claude Code, OpenCode, Hermes Agent, Codex
CLI, GitHub Copilot, and generic frameworks.
LICENSE.md: standard MIT boilerplate.
AGENTS.md: agent loading guide with trigger table, progressive
disclosure rules, troubleshooting, and format compliance references.
Signed-off-by: Jasper <magnus@groktop.us>
Adapted from obra/superpowers (Jesse Vincent, MIT) and expanded with
real-world debugging patterns from production use. Core additions:
Phase 1 sub-steps for common failure modes:
- Schema/environment divergence (test vs production schema diffing)
- Exception type specificity (sibling exception traps in Pyhton)
- Progressive characterization grid (isolate retrieval failures variable by variable)
- Dependency source detection (editable dev forks causing schema drift)
- Systematic web research protocol (structured search before guessing)
- macOS sandboxed app debugging (containers, XPC, TCC, iCloud sync)
- Trace data flow upstream from the symptom
Key heuristics:
- Rule of Three: 3+ failed fixes = question the architecture
- Red Flags table: 12 rationalizations to catch yourself making
- Investigation Flow: keep pushing, don't break momentum to ask questions
Includes two worked example references (dev fork detection, macOS Books.app).
Signed-off-by: Jasper <magnus@groktop.us>
A virtual data architect for teams without one. Includes:
- 8 reference files covering architecture patterns, cloud platforms,
governance maturity, anti-patterns, compliance, vendor evaluation,
case studies, and discovery frameworks
- Interactive governance maturity assessment script
- ADR template for capturing architecture decisions
- 4 Mermaid decision trees for common architecture choices
- QuickScan and proactive discovery flow for users who don't know
where to start
No personal or identifying information included.
CLI wrapper for the WeatherFlow Tempest API: current conditions,
forecast, historical observations, and real-time UDP broadcasts.
Demonstrates all cli-builder patterns in a working, testable project:
- Non-interactive with --json, --dry-run, --quiet, --verbose
- Lazy auth (--help and --dry-run work without a token)
- Multi-device filtering (auto-skips HB hub, prefers ST > SKY > AIR)
- Dual-output via emit() helper
- Structured logging with log/warn/die
- Stderr hygiene and import-time warning suppression
- Idempotent operations
- Global flags in any position (pre-parsed from argv)
Includes the Python CLI script (scripts/tempest-cli) and full API
field layout reference (references/tempest-api-field-layouts.md).
Signed-off-by: Jasper <magnus@groktop.us>
Adds a new Phase 4 section to the cli-builder skill that teaches how
to wrap a CLI tool in an agentskills.io-compliant SKILL.md wrapper,
creating the two-layer architecture: CLI as execution engine + skill
as trigger surface. Includes a complete worked example (weather-cli)
with frontmatter conventions, essential commands, gotchas, and auth
wiring documentation.
Signed-off-by: Jasper <magnus@groktop.us>
10 universal patterns for building CLI tools that AI agents can use
reliably: non-interactive, --json, --dry-run, idempotent, lazy auth,
progressive help, and more. Includes a bash scaffold template, Python
API client reference, advanced edge-case patterns, MCP-vs-CLI decision
framework, and an improvement cycle for iterating on shipped tools.
Principles grounded in real failures from building 15+ agent-facing
CLIs across multiple API services.
Signed-off-by: Jasper <magnus@groktop.us>
SKILL.md distills the full specification from agentskills.io — directory
structure, frontmatter schema, naming rules, progressive disclosure model,
and best practices for skill creation. Includes all 8 source pages as
reference files for on-demand loading.
Magnus Hedemark
Magnus Hedemark