Commit Graph
809 Commits
Author SHA1 Message Date
Magnus Hedemark 88e92f4472 feat: add epub skill v2 — 11 scripts, 9 references, 46 tests
Complete EPUB creation, editing, validation, and knowledge extraction
skill for the Agent Skills open format. Built from spec research, real
EPUB testing on 2.1MB commercial Apress title, and Apple Books
compatibility verification on macOS 26.

Scripts (11):
  epub-scaffold    — Create valid EPUB3 with cover XHTML, Apple Books CSS
  epub-edit        — Surgical editing (8 subcommands, epublib)
  epub-info        — Structure/metadata dump as JSON
  epub-text        — Clean text extraction, per-chapter or single-file
  epub-extract-knowledge — Heuristic + LLM extraction (env var auto-detect)
  epub-validate    — EPUBCheck or Python fallback validation
  epub-images      — List/extract all images with cover detection
  epub-batch       — Multi-file processing (extract-text, validate, metadata)
  epub-convert     — EPUB2→EPUB3 conversion with validation
  epub-repair      — Diagnose & auto-fix common structural issues
  epub-cover       — Add cover XHTML wrapper for Apple Books compatibility

References (9):
  epub-format-internals.md, python-libraries.md, spec-and-validation.md,
  tutorials-and-guides.md, agent-capability-discovery.md,
  fixed-layout-epub.md, accessibility.md, media-overlays.md,
  apple-books-compatibility.md (NEW — verified on macOS 26)

Test: 46/46 passing (test_epub_skill.sh)
2026-05-23 18:08:48 -04:00
Magnus Hedemark 9ebca3e42b Merge pull request 'feat: add subagent supervision, Docker isolation, final SKILL.md wiring' (#27) from feat/supervision-docker-skill-wiring into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/27
2026-05-23 17:17:02 -04:00
Magnus Hedemark 6623267e73 Merge pull request 'feat: add researched code integration references — PyTorch, sklearn, DS workflow' (#26) from feat/code-integration-references into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/26
2026-05-23 17:16:54 -04:00
Magnus Hedemark b13b3917e8 Merge pull request 'feat: add experimental campaign protocol — 8-phase research workflow' (#25) from feat/campaign-protocol into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/25
2026-05-23 17:16:40 -04:00
Magnus Hedemark edb1e7d9bf Merge pull request 'feat: add detect-compute.py — hardware probing for ML feasibility' (#24) from feat/detect-compute-script into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/24
2026-05-23 17:16:23 -04:00
Magnus Hedemark b601ba0f13 feat: add subagent supervision, Docker isolation, final SKILL.md wiring
Closes #22

Features:
- references/subagent-experiment-supervision.md: self-healing experiment
  pattern with 10-failure catalog, auto-fix implementations, escalation
  to Telegram, and harness-specific notes
- references/docker-experiment-isolation.md: resource limits, log
  collection, multi-container sweeps, cleanup patterns, Docker Compose
- scripts/Dockerfile: test image for the skill's Docker-based tests
- SKILL.md: CAMPAIGN type in question classifier, Principle #9,
  Infrastructure Awareness section, all new references in Available
  Resources, updated compatibility field

Test results: 22/22 passing (supervision + Docker build)
2026-05-23 17:12:45 -04:00
Magnus Hedemark dc08b67203 feat: add researched code integration references — PyTorch, sklearn, DS workflow
Three researched references validated against current API docs:

- references/pytorch-integration.md: device management, training loops,
  AMP, torch.compile, transfer learning, LoRA, distillation, pruning,
  DDP, debugging (validated against PyTorch 2.12 docs)

- references/sklearn-integration.md: pipelines, ColumnTransformer,
  model selection, ensembles, calibration, imbalanced data, custom
  estimators, feature selection (validated against sklearn 1.8.0 docs)

- references/data-science-coding-workflow.md: project structure,
  config management, experiment logging (MLflow/TensorBoard/WandB),
  result serialization, reproducibility, data versioning, unit testing

66/66 validation tests passing.

Closes #23
2026-05-23 17:10:10 -04:00
Magnus Hedemark dfddc62656 feat: add experimental campaign protocol — 8-phase research workflow
Structured protocol for running data science research campaigns:
- Phase 1-8 workflow from problem formulation through synthesis
- Entry/exit criteria and failure modes for every phase
- Executable code examples: sklearn pipelines, PyTorch training loops,
  Optuna HP search, distillation, pruning
- See Also references to all companion documents

Part of #22
2026-05-23 17:07:27 -04:00
Magnus Hedemark fe8127f353 feat: add detect-compute.py — hardware probing for ML feasibility
Standalone CLI that probes GPU (nvidia-smi), CUDA version, PyTorch,
scikit-learn, JAX, Optuna, RAM, and disk space — then generates
structured recommendations for model size, batch size, quantization,
and distillation feasibility.

Ships with 12-test suite (7 local + 5 Docker) covering graceful
degradation, all output flags, and a containerized no-GPU scenario.

Part of #22
2026-05-23 17:05:48 -04:00
Magnus Hedemark 5ed56721c6 chore: resolve merge conflict after pulling origin main (data-scientist merged, epub added locally) 2026-05-23 16:48:10 -04:00
Magnus Hedemark 975f295c94 Merge pull request 'feat: add data-scientist skill — PhD-level data science expertise for agents' (#21) from feature/data-scientist-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/21
2026-05-22 16:36:37 -04:00
Magnus Hedemark 487f8923dc feat: add data-scientist skill
PhD-level data science expertise with decision framework, five reference
documents (statistical methodology, experimental design, causal inference,
regression modeling, Bayesian workflow), five automation scripts (power
analysis, assumption diagnostics, model comparison, effect size calculator,
experimental design generator), and two report templates.

Python default with --engine r flag for R output. Dual language support.
2026-05-22 16:35:31 -04:00
Magnus Hedemark cecdecf6b0 Merge pull request 'fix(cli-builder): align Phase 4 architecture with scripts/ convention' (#20) from fix/cli-builder-phase4-scripts-convention into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/20
v0.1.1
2026-05-22 16:13:15 -04:00
Magnus Hedemark c949fe4b5d fix(cli-builder): align Phase 4 architecture diagram with scripts/ convention
The "Completed Architecture" diagram in Phase 4 showed the CLI binary at the
skill root, but every other skill in this repo (and the Agent Skills spec)
places executable scripts in a `scripts/` subdirectory.

Changes:
- Replaced ASCII-art two-layer diagram with concrete directory structure
  showing `scripts/servicex-cli` inside the skill directory
- Added Trigger/Execute layer table clarifying the role of each file
- Updated the "Agent opens session" flow to use `scripts/` relative paths
- Added deployment model comparison (scripts/ inside skill vs global PATH)
- Updated the "Installation instructions" entry in What NOT to Put table

Trigger: neopabo on Nous Research Discord
Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-22 16:05:53 -04:00
Jasper (AI Assistant) 4d929dd85f Merge pull request 'feat: add jira-jql skill — expert JQL reference' (#18) from feat/jira-jql-skill into main 2026-05-22 09:15:04 -04:00
Magnus Hedemark 82569dc75a feat: add jira-jql skill — expert JQL reference
Comprehensive Jira Query Language skill covering:
- All operators, keywords, and core syntax
- Complete function catalog (date/time, user, sprint/version,
  issue, custom field, JSM SLA/approval/organization)
- History operators (WAS/CHANGED) with predicate clauses
- Relative date expressions and dynamic patterns
- Performance best practices and common mistakes
- Role-based ready queries (dev, scrum master, PO, admin)
- REST API usage, edge cases, and troubleshooting
- Three companion reference files
2026-05-22 09:11:59 -04:00
Magnus Hedemark 74a9a9ebbd Merge pull request 'Add kanban-guru skill — virtual Kanban expert' (#17) from feat/kanban-guru-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/17
2026-05-22 01:19:33 -04:00
Magnus Hedemark 555cf087d9 feat: add kanban-guru skill
A virtual Kanban expert skill with rich reference material covering all
seven cadences, classes of service, Little's Law, flow metrics,
multi-portfolio operating models, and Scrum-to-Kanban transitions.

- SKILL.md: diagnosis, design, and transition modes with QuickScan
- references/cadences.md: all seven cadences with agendas and formats
- references/classes-of-service.md: four canonical + custom classes
- references/flow-metrics.md: SLEs, CFDs, forecasting, right-sizing
- references/multi-portfolio.md: capacity allocations, board design
- references/transition-guide.md: Scrum-to-Kanban playbook
- references/wip-limits.md: Little's Law, calibration, breach signals
- references/glossary.md: A-Z kanban terminology

Sanitized for public use — no private context or references.
2026-05-22 01:16:37 -04:00
Magnus Hedemark 14d0735491 docs: alphabetize and complete README skill index
Adds 4 missing skills (arr-cli, peertube, trakt, transistor)
and sorts all 18 skills alphabetically.

Signed-off-by: Jasper <magnus@groktop.us>
v0.1.0
2026-05-21 23:51:36 -04:00
Magnus Hedemark 96946fba68 Merge pull request 'feat: add peertube skill' (#16) from feat/peertube-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/16
2026-05-21 23:47:23 -04:00
Magnus Hedemark 300767ae6a Merge pull request 'feat: add transistor skill' (#15) from feat/transistor-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/15
2026-05-21 23:47:10 -04:00
Magnus Hedemark 85cd7121a1 Merge pull request 'feat: add trakt skill' (#14) from feat/trakt-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/14
2026-05-21 23:46:59 -04:00
Magnus Hedemark 5bb84401c0 feat: add peertube skill — PEERTUBE CLI 2026-05-21 23:46:32 -04:00
Magnus Hedemark f5521d97da feat: add transistor skill — TRANSISTOR CLI 2026-05-21 23:46:31 -04:00
Magnus Hedemark 08f5791bca feat: add trakt skill — TRAKT CLI 2026-05-21 23:46:30 -04:00
Magnus Hedemark e067d7a7ad Merge pull request 'feat: add arr-cli skill — Radarr + Sonarr media library CLI' (#13) from feat/arr-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/13
2026-05-21 23:37:23 -04:00
Magnus Hedemark ada4d7261a feat: add arr-cli skill — Radarr + Sonarr media library CLI
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>
2026-05-21 23:36:43 -04:00
Magnus Hedemark dfb038f5f1 Merge pull request 'feat: add ghost-cli skill — Ghost CMS CLI' (#12) from feat/ghost-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/12
2026-05-21 23:30:05 -04:00
Magnus Hedemark 4837585788 Merge pull request 'feat: add jellyfin-cli skill — Jellyfin media server CLI' (#11) from feat/jellyfin-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/11
2026-05-21 23:29:58 -04:00
Magnus Hedemark e10d16fab6 Merge pull request 'feat: add openlibrary-cli skill — Open Library book metadata CLI' (#10) from feat/openlibrary-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/10
2026-05-21 23:29:49 -04:00
Magnus Hedemark 3900ecc63d Merge pull request 'feat: add tmdb-cli skill — The Movie Database API CLI' (#9) from feat/tmdb-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/9
2026-05-21 23:29:41 -04:00
Magnus Hedemark c0378be48e docs: add 7 new API CLI skills to README index 2026-05-21 23:25:51 -04:00
Magnus Hedemark 6b7ac181ff feat: add ghost-cli skill — Ghost CMS CLI
CLI wrapper for the Ghost CMS Admin API v5/v6. Commands: site,
posts (list), create-post, pages (list), tags (list).

All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via GHOST_URL and GHOST_ADMIN_KEY (id:secret
format). JWT token generation handled internally (HS256, 5-min expiry).

Signed-off-by: Jasper <magnus@groktop.us>
2026-05-21 23:24:57 -04:00
Magnus Hedemark fad0cf5b79 feat: add jellyfin-cli skill — Jellyfin media server CLI
CLI wrapper for the Jellyfin media server API. Commands: info,
recent (with --movies/--episodes filters), search, libraries, stats.

All cli-builder patterns: --json, --dry-run, --quiet, --verbose,
lazy auth, emit() dual-output, structured logging, pre-parsed
global flags. Auth via JELLYFIN_URL and JELLYFIN_API_KEY.

Signed-off-by: Jasper <magnus@groktop.us>
2026-05-21 23:24:51 -04:00
Magnus Hedemark 1a8aedd131 feat: add openlibrary-cli skill — Open Library book metadata CLI
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>
2026-05-21 23:24:45 -04:00
Magnus Hedemark 1a22c74d53 feat: add tmdb-cli skill — The Movie Database API CLI
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>
2026-05-21 23:24:39 -04:00
Magnus Hedemark e5acc749bf Merge pull request 'feat: add forgejo-cli skill — Forgejo/Gitea Git forge CLI' (#8) from feat/forgejo-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/8
2026-05-21 23:15:05 -04:00
Magnus Hedemark f08b21d2d6 feat: add forgejo-cli skill — Forgejo/Gitea Git forge CLI
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>
2026-05-21 23:14:20 -04:00
Magnus Hedemark 8dd456d046 Merge pull request 'feat: add confluence-cli skill — Confluence wiki from the terminal' (#7) from feat/confluence-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/7
2026-05-21 23:13:10 -04:00
Magnus Hedemark da2e0b3671 feat: add confluence-cli skill — Confluence wiki from the terminal
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>
2026-05-21 23:09:33 -04:00
Magnus Hedemark 0e819fb3fd Merge pull request 'feat: add jira-cli skill — Jira issue tracker from the terminal' (#6) from feat/jira-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/6
2026-05-21 23:07:04 -04:00
Magnus Hedemark fe56c05b89 feat: add jira-cli skill — Jira issue tracker from the terminal
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>
2026-05-21 23:03:45 -04:00
Magnus Hedemark 1c08781360 fix: replace guessed installation paths with links to official harness docs
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>
2026-05-21 22:57:15 -04:00
Magnus Hedemark eb185d8a27 fix: correct Codex CLI skill directory (was hallucination)
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>
2026-05-21 22:55:51 -04:00
Magnus Hedemark c1d13b95c6 docs: add AGENTS.md, LICENSE.md, curated README with installation sections
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>
2026-05-21 22:53:03 -04:00
Magnus Hedemark 0fd760b89c Merge pull request 'feat: add systematic-debugging skill — 4-phase root cause protocol' (#5) from feat/systematic-debugging-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/5
2026-05-21 22:48:38 -04:00
Magnus Hedemark 1e9fd74ea7 feat: add systematic-debugging skill — 4-phase root cause protocol
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>
2026-05-21 22:46:32 -04:00
Magnus Hedemark eec8c7e851 Merge pull request 'feat: add software-architecture-analysis skill' (#4) from feat/software-architecture-analysis-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/4
2026-05-21 22:39:15 -04:00
Magnus Hedemark f6cba81763 Merge pull request 'feat: add tempest-cli skill — hyper-local weather from Tempest station' (#3) from feat/tempest-cli-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/3
2026-05-21 22:38:53 -04:00
Magnus Hedemark 941d5c36dc feat: add software-architecture-analysis skill
7-phase methodology for reverse-engineering codebases and producing
clean-room design documents under new constraints. Core workflow:

Phase 1: Clone & map repository structure
Phase 2: Find key architectural files (sort by line count)
Phase 3: Map architecture with Mermaid diagrams
Phase 3b: Extract implicit storage/provider contracts (DAO design)
Phase 4: Inventory feature surface
Phase 5: Write clean-room specification (no code contamination)
Phase 6: Break constraints (local-first, privacy-first redesign)
Phase 7: Post-delivery QA (link integrity, diagram rendering)

Includes a full worked example of the interface extraction pattern
(references/interface-extraction-pattern.md) using the cashew
thought-graph library — demonstrating all five steps from philosophy
reading through two-provider proof concept.

Signed-off-by: Jasper <magnus@groktop.us>
2026-05-21 22:36:29 -04:00