Commit Graph
809 Commits
Author SHA1 Message Date
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
Jasper (AI Assistant) a1458820d1 Merge pull request 'Add yc-default-alive-calculator and yc-weekly-growth-compass skills' (#63) from yc-entrepreneurial-toolbox into main 2026-06-13 14:54:11 -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
Jasper (AI Assistant) f6afae7d84 Merge pull request 'fix(bundle-builder): generate umbrella SKILL.md as discoverable entry point' (#53) from fix/bundle-builder-umbrella-entry into main 2026-06-13 14:53:29 -04:00
Magnus Hedemark 9372e4d1ee fix(bundle-builder): generate umbrella SKILL.md as discoverable entry point
Add Step 0 to the bundle-builder file creation order: generate and
register an umbrella SKILL.md at the bundle root before any sub-skills
are created. The umbrella provides the auto-detectable entry point
with broad trigger conditions, Mermaid flowchart, phase table, and
navigation instructions.

Also update:
- workflow-architect SKILL.md: list umbrella in 'What You Get' and
  update Loading Protocol step 5 to mention registration
- workflow-architect AGENTS.md: add Registration section explaining
  how umbrella and sub-skills are registered via skill_manage()

Closes #52
2026-06-13 14:53:22 -04:00
Jasper (AI Assistant) cdc2edc2a6 Merge pull request 'fix(bundle-builder): register generated sub-skills with skill_manage' (#51) from fix/bundle-builder-register-skills into main 2026-06-13 14:46:14 -04:00
Magnus Hedemark 4176886e99 Merge pull request 'feat: add gutenberg skill — search, download, extract public-domain books' (#64) from feat/gutenberg-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/64
2026-06-13 14:26:38 -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 9483280946 Fix 3 wrong service names in Raleigh dataset catalog
- Existing Bicycle Infrastructure: ExistingBicycleInfrastructure_Public → Existing_Bicycle_Infrastructure
- Speed Humps: Speed_Humps → SpeedHumps
- EVSE Stations: EVSE_Stations → EVSE_Stations_View

All three verified against live API — returning real data now.
2026-06-12 00:13:25 -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
Jasper (AI Assistant) f2ea105f65 Merge pull request 'Scrub personal identifiers from public skill files' (#62) from scrub-personal-identifiers into main 2026-06-05 23:32:03 -04:00
Magnus Hedemark 776734616a scrub personal identifiers from public skill files
Replace 'Jasper' and 'Magnus Hedemark' references with generic
placeholders in skill metadata, example templates, and agent
instructions. These files are consumed by the public repo and
should not contain personal names.

- SKILL.md: author: Jasper → author: agent-skills
- phase-1-filing-issues.md: example disclosure genericized
- agent-checklist.md: first-person framing generalized
2026-06-05 23:31:17 -04:00
Jasper (AI Assistant) 24562ec552 feat: add prowlarr-cli — Prowlarr indexer management CLI with skill and references (#60) 2026-06-04 00:11:20 -04:00
Jasper (AI Assistant) 6d5f1580f9 feat: add lidarr-cli — Lidarr music library CLI with skill and references (#59) 2026-06-03 23:38:37 -04:00
Jasper (AI Assistant) 8720bc7569 fix: wire add, quality-profile, search CLIs; progressive disclosure SKILL.md + test suite (#58) 2026-06-03 23:28:41 -04:00
Jasper (AI Assistant) acabd85dce fix: add umbrella SKILL.md to 'What You Get' and update Loading Protocol (fixes #52) (#57) 2026-06-03 23:13:09 -04:00
Jasper (AI Assistant) 4b9373fcd1 fix: bundle-builder now registers sub-skills with Hermes skill system (fixes #50) (#56) 2026-06-03 23:11:17 -04:00
Jasper (AI Assistant) 89b19b6d24 fix: forgejo-cli --labels now passes integers instead of strings (fixes #48) (#55) 2026-06-03 23:07:59 -04:00
Magnus Hedemark 3e8fd4d502 fix(bundle-builder): register generated sub-skills with skill_manage
After writing bundle files, iterate through each sub-skill and register
it using skill_manage(action='create', ...) so Hermes can discover it
via skill_view() and skills_list(). Sub-skills get a '<bundle-name>/'
prefix to avoid naming collisions across bundles.

Closes #50
2026-05-29 22:56:56 -04:00
Magnus Hedemark 9614fff0b5 Merge pull request 'feat(arr-cli): omnibus SkillOpt improvements — add docs, series types, quality profiles' (#49) from feat/arr-cli-skillopt-omnibus into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/49
2026-05-29 21:55:20 -04:00
Magnus Hedemark d914bde01a feat(arr-cli): add series add, series-type, quality-profile, and episode-file docs
Documentation improvements from SkillOpt Epoch 1-3 optimization:

- Add radarr-cli add and quality-profile command documentation
- Add sonarr-cli add with --series-type (Standard/Daily/Anime)
- Add episode get and episode-file list examples
- Add sonarr-cli quality-profile documentation
- Add --no-season-folder documentation for Anime series

Closes #45, #46, #47
2026-05-29 21:54:07 -04:00
Magnus Hedemark 3ce4733c86 docs: fix AGENTS.md reference — replace deleted kanban-board.yaml.tmpl with new templates 2026-05-29 21:38:20 -04:00
Magnus Hedemark c851ca495a Merge pull request 'feat: add kanban integration to workflow-architect bundle — task-dependency model for linear workflows' (#44) from feat/workflow-architect-kanban into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/44
2026-05-29 21:37:38 -04:00
Magnus Hedemark 888eb62ec9 feat: add kanban integration to workflow-architect bundle — task-dependency model for linear workflows
Replaces the lane-based kanban-board.yaml.tmpl with a Hermes-compatible
task-dependency model using parent/child task relationships.

Changes:
- Delete templates/kanban-board.yaml.tmpl (wrong model — Hermes Kanban
  doesn't have lanes)
- Create templates/kanban-board-setup.sh.tmpl — board creation script template
- Create templates/kanban-task-blueprints.yaml.tmpl — phase-to-task mapping
- Update bundle-builder/SKILL.md Section 6 for new kanban model
- Update kanban-decision-criteria.md Implementation section with Hermes
  task-dependency model and lifecycle rules
- Create references/example-output/developer-pipeline-kanban/ — linear
  build->review->deploy workflow with full kanban board, task blueprints,
  and usage guide
- Cross-reference the two examples (non-kanban developer-triage and
  kanban-enabled developer-pipeline-kanban)
- Update manifest.yaml.tmpl with kanban metadata slot
2026-05-29 21:36:12 -04:00
Magnus Hedemark 5c4e0618e7 Merge pull request 'feat: add workflow-architect bundle — workflow discovery and skills bundle generator' (#43) from feat/workflow-architect-bundle into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/43
2026-05-29 21:30:16 -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 88f9db6b9c Merge pull request 'feat: add pr create to forgejo-cli CLI and docs' (#42) from feat/forgejo-cli-pr-create into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/42
2026-05-28 22:48:00 -04:00
Magnus Hedemark 2405f557aa feat: add pr create to forgejo-cli CLI and docs
Implements pr_create method and 'pr create' subcommand, closing the
long-standing Known Gap. Adds usage examples to Common Operations section
and updates the command listing.

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-28 21:49:02 -04:00
Magnus Hedemark 1a9747269f feat: add pr create to forgejo-cli
Implements pr_create method and 'pr create' subcommand for the forgejo-cli,
closing the long-standing Known Gap. Supports --head, --base, --title,
--body, and --draft flags.

Removes the 'pr create' entry from the Known Gaps table in the skill docs.

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-28 21:46:30 -04:00
Magnus Hedemark f43f779ec4 Merge pull request 'feat: add opensource-contributions skill' (#41) from feat/opensource-contributions-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/41
2026-05-28 21:45:50 -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
Jasper (AI Assistant) ec943b8502 Merge pull request 'feat: add lastfm skill — Last.fm music data API with discovery pipeline' (#40) from feat/lastfm-skill into main
feat: add lastfm skill — Last.fm music data API with discovery pipeline
2026-05-28 13:32:45 -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 0589de3718 Merge pull request 'feat: add tailscale bundle — first bundle in bundles/ directory' (#39) from feat/tailscale-bundle into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/39
Currently untested.
2026-05-28 00:15:45 -04:00
Magnus Hedemark 96caf3ae06 feat: add tailscale bundle — self-hosted Tailscale/Headscale skill collection
Adds the first bundle to the agent-skills repo under bundles/:
a collection of 7 sub-skills for managing the self-hosted
Tailscale/Headscale VPN ecosystem.

Includes 23 scripts (bash + python), 8 reference documents,
6 deployment templates, and a context-aware umbrella SKILL.md
that auto-loads sub-skills by trigger keywords.
2026-05-28 00:14:30 -04:00
Magnus Hedemark bd94249c88 Merge pull request 'docs: add pitfalls reference doc and version tracking to nous-branding skill' (#38) from feat/pitfalls-and-versioning into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/38
2026-05-26 14:10:40 -04:00
Magnus Hedemark 9eca0ec761 docs: add pitfalls reference doc and version tracking to nous-branding skill
Adds references/pitfalls.md cataloging known failure modes across
6 categories (mascot generation, image editing, safety, provider
quirks, prompt engineering, pipeline tooling) with a quick-reference
fix table.

Updates SKILL.md with version 1.1.0 in frontmatter and a consolidated
'What Is NOT On-Brand' section with anti-pattern table.

Closes #37

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-26 14:10:17 -04:00
Magnus Hedemark d46fbf6003 Merge pull request 'refactor: add style lane system and reference catalog to nous-branding SKILL.md' (#36) from feat/style-lane-system into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/36
2026-05-26 14:09:57 -04:00
Magnus Hedemark 3da776f75b refactor: add style lane system and reference catalog to nous-branding SKILL.md
Restructures the generation guidance into 6 explicit style lanes
(Xerox Poster, Manual/Letterpress, Industrial Duotone, Minimal
Stipple, Blue Registration, Legacy PNW/Celestial) with prompt
templates and per-lane guidance.

Adds a reference catalog table mapping each assets/ image to its
recommended style lanes and use cases.

Closes #35

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-26 14:09:41 -04:00
Magnus Hedemark 2a84712336 Merge pull request 'feat: add post-processing script for analog print effects' (#34) from feat/postprocess-script into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/34
2026-05-26 14:09:18 -04:00
Magnus Hedemark 612086170d feat: add post-processing script for analog print effects
Adds scripts/postprocess.py with 14 analog-print degradation effects
(warm grade, CRT scanlines, film grain, Bayer dither, vignette,
chromatic aberration, screen print texture, paper fiber, ink bleed,
palette compression, xerox threshold, registration offset, plate
wobble, print scuffs) and corresponding SKILL.md documentation.

Adapted from the approach pioneered by plntrprotocol/nous-branding
(MIT) — same goals, independent implementation.

Supports three modes: imprint (full 14 effects), nous (9 base effects),
standard (6 light effects). Intensity calibration from 0.45 to 0.8+.

Closes #33

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-26 14:09:03 -04:00
Magnus Hedemark 58b9c95fee Merge pull request 'docs: acknowledge plntrprotocol/nous-branding parallel development in README' (#32) from docs/acknowledge-plntr-nous-branding into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/32
2026-05-26 14:07:37 -04:00
Magnus Hedemark 9d1cd8b47c docs: acknowledge plntrprotocol/nous-branding parallel development in README
Add a cross-pollination note under the nous-branding skill entry
acknowledging that plntrprotocol/nous-branding was developed
independently and in parallel. Links to their repo and encourages
users to check it out.

Closes #31

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-05-26 14:03:55 -04:00
Magnus Hedemark 14c3fa286e Merge pull request 'feat: add brand-designer skill — brand identity documentation toolkit' (#30) from brand-designer-init into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/30
v0.2.2
2026-05-24 19:11:13 -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 f902c663ef Merge pull request 'feat: add nous-branding skill — brand identity guide with reference-image generation' (#29) from feat/nous-branding-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/29
v0.2.1
2026-05-24 13:35:44 -04:00
Magnus Hedemark d9786d0644 fix: add missing nous-girl-style-reference.png asset 2026-05-24 13:34:23 -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 7c8b0ece9f Merge pull request 'feat: add epub skill v2' (#28) from feat/epub-skill into main
Reviewed-on: https://git.brandyapple.com/magnus/agent-skills/pulls/28
v0.2.0
2026-05-23 18:10:52 -04:00