Commit Graph
36 Commits
Author SHA1 Message Date
Magnus Hedemark 7ae6a72308 Merge branch 'main' into docs/issue-72-exit-conditions 2026-07-11 17:15:47 -04:00
Magnus Hedemark a2298afe08 Merge branch 'main' into docs/issue-70-use-when-sections 2026-07-11 17:15:28 -04:00
Magnus Hedemark 4827413f31 Merge branch 'main' into fix/issue-69-confirmation-gates 2026-07-11 17:15:04 -04:00
Magnus Hedemark f0efb25d91 docs(skills): define completion and exit conditions 2026-07-11 17:02:59 -04:00
Magnus Hedemark 87051aeba8 docs(skills): define use-when guidance 2026-07-11 17:02:57 -04:00
Magnus Hedemark 0546ddcb9d docs(skills): standardize confirmation gates 2026-07-11 17:02:54 -04:00
Magnus Hedemark 7704ded9c0 feat(flaresolverr): add browser challenge CLI skill 2026-07-11 17:01:03 -04:00
Magnus Hedemark d6bc6ffe8b feat: add comprehensive Kubernetes agent skill 2026-07-11 16:27:12 -04:00
Jasper (AI Assistant) 637c12d832 fix: align skill audit conventions (#101) 2026-07-11 15:40:50 -04:00
Magnus Hedemark f340dc1c62 feat: add portable docker-compose skill 2026-07-11 07:58:31 -04:00
Magnus Hedemark 3a4aad40bf feat: add agent-council — multi-agent structured debate system
Spawns a panel of expert agents to debate any question with
convergence-aware iteration and typed synthesis output.

- PydanticAI + PydanticGraph-based Python package
- 5-phase debate protocol: compose → premortem → position →
  cross-examine (iterative, eval-driven) → synthesis
- Convergence detection: confidence dispersion, argument
  novelty, concession rate — stops when diminishing returns
- Typed output schemas (Pydantic models) for every phase
- CLI tool with markdown and JSON output modes
- Custom persona file support
- Bootstrap detection: sys.executable -m pip install fallback
- agentskills.io compatible SKILL.md with triggers

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-07-09 22:55:30 -04:00
Magnus Hedemark 0c772a16b9 Add README.md requirement to AGENTS.md governance
- Added 'Human-readable README' row to the Format Compliance table
- New README Format section defining 6 required sections + style guidance
- Added README validation to the Validate Your Output checklist
- References data-scientist/README.md as the canonical format example
2026-07-09 22:36:49 -04:00
Magnus Hedemark e4a11880d1 feat: add pydanticai skill — PydanticAI & PydanticGraph expert reference
Comprehensive agent skill covering:
- Agent creation, function tools, dependency injection, instructions
- 20+ capability system with on-demand (deferred) loading
- Lifecycle hooks system (before/after/wrap for all phases)
- 16 model providers, FallbackModel, ConcurrencyLimitedModel
- Structured output, streaming, output functions
- Multi-agent delegation and programmatic hand-off
- PydanticGraph: both BaseNode (class-based) and GraphBuilder (function-based)
  with parallel execution, joins/reducers, decisions, Mermaid rendering
- Testing with TestModel/FunctionModel and eval framework
- MCP integration, durable execution, UI adapters
- 8 comprehensive reference files + API quick reference

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-07-08 23:50:36 -04:00
Magnus Hedemark 4a73657522 feat: add langgraph expert skill — multi-agent patterns, scaffolds, evals, and production guidance
Comprehensive LangGraph skill covering:
- Core architecture: Graph API, Functional API, state management, agent loops
- Three multi-agent patterns: supervisor (~94% accuracy), swarm (~40% fewer LLM calls),
  hierarchical teams (subgraphs with nested state)
- Persistence: checkpointers vs stores, per-invocation/per-thread/stateless modes
- Production: Agent Server deployment, LangSmith observability, 8 failure modes
- Evals: routing accuracy, resolution coverage, LLM-as-judge methodology
- Troubleshooting: symptom→cause→fix tables per pattern
- 3 Python scripts: supervisor scaffold, swarm scaffold, eval generator
- 3 runnable templates: supervisor, swarm, subgraph composition

Ships 8 reference files, 3 scripts, and 3 templates.
2026-07-08 14:54:53 -04:00
Magnus Hedemark 3f03c6e327 feat: add product-discovery skill — Phase 0 methodology for requirements discovery upstream of SDD
Covers stakeholder mapping, question patterns, gap detection, conflict
resolution, transcript-to-spec distillation, AI-conducted discovery,
power dynamics, and time-constrained discovery. Ships 8 references and
5 templates.
2026-07-06 13:29:44 -04:00
Magnus Hedemark 980f87050d feat: spec-driven-development v1.2.0 — SDD methodology for AI software factories 2026-07-06 00:09:07 -04:00
Magnus Hedemark 0b9150540f feat: add crowdsec skill — comprehensive IPS/IDPS/WAF reference 2026-07-05 22:06:37 -04:00
Magnus Hedemark c05bf92312 feat: add color-management skill (squash with fortification) 2026-07-05 16:06:04 -04:00
Magnus Hedemark 71b6335766 feat: add traefik — comprehensive Traefik v3 reverse proxy skill
Deploy, configure, secure, and maintain Traefik v3 with full coverage of
static configuration, Docker provider labels, HTTP/TCP/UDP routing, all 25+
built-in middlewares, TLS/ACME (Let's Encrypt), API/dashboard, observability,
v2-to-v3 migration, and production deployment patterns.

Ships 10 reference files:
- static-configuration.md — complete YAML schema with all keys and defaults
- docker-provider.md — full Docker label reference with examples
- http-routing.md — all rule matchers, priority, syntax
- middleware-catalog.md — every middleware with YAML config
- tls-acme.md — ACME resolvers, challenges, TLS options, custom certs
- tcp-routing.md — TCP/UDP routing, SNI matching, TLS passthrough
- api-dashboard.md — all API endpoints, dashboard security
- observability.md — Prometheus/OTel metrics, access logs, tracing, ping
- migration-v2-to-v3.md — breaking changes and migration steps
- production-deployment.md — Docker Compose, security hardening, HA

Source: https://doc.traefik.io/traefik/
Signed-off-by: Jasper <magnus@groktop.us>
2026-07-05 14:59:31 -04:00
Magnus Hedemark e151580319 Add github-runner skill: deploy, manage, and troubleshoot self-hosted GitHub Actions runners
- SKILL.md with trigger table, quick reference, deployment spectrum, and pitfalls
- references/ for architecture, deployment (systemd/Docker/ARC/Scale Set Client),
  security, autoscaling, management, custom images, and network
- templates/ for docker-compose.yml and custom-runner.Dockerfile
- AGENTS.md updated with trigger row in alphabetical order
2026-06-23 00:13:55 -04:00
Magnus Hedemark 29ecf795c4 Add design/UX/accessibility reference to hugo-theme skill 2026-06-19 15:38:54 -04:00
Magnus Hedemark 90783af84d Add hugo-theme skill: advanced Hugo CMS theme development
Six reference files covering template architecture, asset pipeline,
shortcodes and render hooks, content organization and i18n, modules
and performance optimization, and SEO/output formats/CI/CD.
2026-06-19 15:28:27 -04:00
Magnus Hedemark caa46d9c05 feat: add open-knowledge-format skill
Google's Open Knowledge Format (OKF) v0.1 — an open, vendor-neutral
spec for representing knowledge as markdown files with YAML frontmatter,
designed for AI agent consumption.

- SKILL.md: core instructions, frontmatter spec, conformance criteria,
  cross-linking rules, relationship to other formats, quick start
- references/spec-summary.md: full OKF v0.1 specification reference
- references/bundle-architecture.md: directory structure and conventions
- references/use-cases.md: real-world adoption and patterns
- scripts/okf-bundle-validate.py: validate OKF bundle structure
- assets/concept-template.md: template for creating concept files
- assets/example-bundle/: minimal conformant OKF bundle
2026-06-18 12:18:35 -04:00
Magnus Hedemark d8a11c2a4b Add yc-default-alive-calculator and yc-weekly-growth-compass skills
Two research-grounded entrepreneurial tools based on Paul Graham's Y Combinator
frameworks, with companion CLI scripts and extensive reference material.

yc-default-alive-calculator:
- Paul Graham's 'Default Alive / Default Dead' framework as a deterministic CLI
- Month-by-month financial projection engine with growth decay modeling
- Burn multiple analysis, lever identification, and actionable verdict
- Zero external dependencies (Python 3.9+ stdlib only)
- 2 reference docs (framework deep-dive, fundraising context)

yc-weekly-growth-compass:
- Paul Graham's 'Startup = Growth' framework as an operational weekly tool
- Single-period and time-series growth rate computation
- YC benchmark classification (1% concerning -> 10%+ outstanding)
- Compound growth projections, doubling time, and decision compass
- Zero external dependencies (Python 3.9+ stdlib only)
- 2 reference docs (framework essay breakdown, compound growth table)

Both skills follow the Agent Skills open format (agentskills.io spec v1.0).
2026-06-13 14:53:50 -04:00
Magnus Hedemark b2cb7d9672 feat: add gutenberg skill — search, download, and extract public-domain books from Project Gutenberg
Ships a portable Python CLI (stdlib only, zero external dependencies) with:
- search: keyword search via gutendex API
- metadata: full book metadata by Gutenberg ID
- download: plain text, EPUB, or HTML format
- extract: strip PG boilerplate or extract text from EPUB
- classify: fiction vs non-fiction classification
- pipeline: full search → download → extract → classify workflow

AgentSkills.io compliant with SKILL.md, scripts/gutenberg, and
references/epub-extraction.md for progressive disclosure.
2026-06-13 14:24:19 -04:00
Magnus Hedemark 9afed5d704 Add raleigh skill — CLI for City of Raleigh Open Data portal
Query, search, and download from 170+ public datasets via the
ArcGIS REST API. Ships a zero-dependency Python CLI with:
catalog, search, info, query, download, and categories commands.

Includes:
- SKILL.md with trigger conditions and reference table
- references/dataset-catalog.md — full 170+ dataset inventory
- references/api-reference.md — ArcGIS REST API documentation
- scripts/raleigh — executable CLI tool
2026-06-12 00:02:03 -04:00
Magnus Hedemark 79cf37a44a feat: add workflow-architect bundle — meta-skill for workflow discovery and skills bundle generation
A new Agent Skills bundle that helps users discover their actual workflow
through two modes:

- Active interrogation: guided 8-15 question interview that adapts based on
  answers, building a structured model of the user's workflow phases,
  branching signals, tool preferences, and friction points

- Passive observation: loads silently, then on trigger phrase scans session
  context to infer workflow patterns from what actually happened

The output is a skills bundle: sub-skills per workflow phase with trigger
conditions, a manifest, a Mermaid decision map, and optionally a kanban
board if the workflow is deterministic/linear.

Ships 3 sub-skills (interviewer, observer, bundle-builder), 3 reference
documents (workflow archetypes, trigger condition patterns, kanban
decision criteria), 4 templates, and a worked example output bundle.

Also fixes broken table formatting in AGENTS.md (extra pipe characters
in trigger table rows).
2026-05-29 21:29:56 -04:00
Magnus Hedemark c5c4d2434a feat: add opensource-contributions skill
Comprehensive open source contribution guidance with progressive disclosure.
Restructured from a single ~23K-token monolithic SKILL.md into a concise
~1.2K-token orchestrator with 10 focused reference files.

Changes:
- SKILL.md: 1,720 lines → 100 lines (AgentSkills.io compliant frontmatter)
- 10 new reference files covering phases 0a-4, pitfalls, default posture
- Portable PR template compliance checker script (stdlib-only)
- All personal context scrubbed for public export
- AGENTS.md + README.md updated with trigger table entry

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-28 21:43:30 -04:00
Magnus Hedemark b864a312c7 feat: add lastfm skill — Last.fm music data API with discovery pipeline
A skill wrapping the lastfm-cli tool for the Last.fm music data API:
user listening history, artist/album/track metadata, collaborative
filtering-based similar music discovery, global/per-country charts,
search, tags, and scrobble/love/now-playing write operations.

Includes a Music Discovery Pipeline section for turning liked tracks
into recommendations via Last.fm's collaborative filtering graph.
2026-05-28 13:31:09 -04:00
Magnus Hedemark 74b8370fa7 feat: add brand-designer skill — brand identity documentation toolkit
Create comprehensive brand identity documentation for any brand:
- 7 markdown templates: brand-card, strategy, visual-id, voice,
  application, governance, asset-inventory
- brand-book CLI: init, compile (--artifact selector), validate,
  preview — all with --json and --dry-run support
- generate script: brand-card, mockup, swatch, moodboard,
  logo-bg image prompts (reference-image-aware)
- 6 reference files: canonical components, gold-standard analysis,
  artifact hierarchy, format comparison, template schemas,
  image generation patterns
- 12/12 tests passing

PR co-authored by: Jasper (AI agent on behalf of Magnus Hedemark)

Signed-off-by: Magnus Hedemark
2026-05-24 19:06:36 -04:00
Magnus Hedemark dc2981b129 feat: add nous-branding skill — brand identity guide with reference-image generation
- Complete Nous Research brand identity documentation
- Official Nous Girl mascot specs from the brand booklet
- Color palette (Electric Blue #3847FF + 5 more), typography system,
  texture system, design principles
- 7 reference images in assets/ (3 official from brand booklet, 4 generated)
- scripts/generate-with-ref.py — hits OpenAI /v1/images/edits directly with
  reference image upload, bypassing text-only image_generate tool
- 4 prompt templates: text-only, mascot portrait, system sheet, reference-image
- Brand compliance checklist
- AGENTS.md trigger table and README.md index updated
2026-05-24 13:34:00 -04:00
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 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 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 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 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