Commit Graph
809 Commits
Author SHA1 Message Date
Magnus Hedemark 2058db71d2 Merge pull request 'feat: add data-architect skill' (#2) from feat/data-architect-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/2
2026-05-21 22:34:15 -04:00
Magnus Hedemark 15ba8bb82a feat: add data-architect skill
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.
2026-05-21 22:33:45 -04:00
Magnus Hedemark f2756491b7 feat: add tempest-cli skill — hyper-local weather from Tempest station
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>
2026-05-21 22:33:20 -04:00
Magnus Hedemark f8085d9904 Merge pull request 'feat: add cli-builder skill — agent-friendly CLI design patterns' (#1) from feat/cli-builder-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/1
2026-05-21 22:20:24 -04:00
Magnus Hedemark 0f38fd56a7 feat: add Phase 4 (Skillify) and skill-wrapper-example reference
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>
2026-05-21 22:20:09 -04:00
Magnus Hedemark a1c83765a3 feat: add cli-builder skill — agent-friendly CLI design patterns
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>
2026-05-21 22:17:23 -04:00
Magnus Hedemark dd11cfefb4 add agent-skills: reference skill documenting the Agent Skills open format
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.
2026-05-21 21:55:11 -04:00
Magnus Hedemark b3b619ed71 ground README: describe what's real, not what's aspirational 2026-05-21 21:53:05 -04:00
Magnus Hedemark 1fce5c6124 Initial commit: repo scaffold with .gitignore and README 2026-05-21 21:51:38 -04:00