skills/magnus919_agent-skills

Fork 0

mirror of https://github.com/magnus919/agent-skills.git synced 2026-09-11 19:47:12 +03:00

Files

T

History

d68c1b3552 fix(evals): reword expectations prose in agent-skills eval manifest (#237 ) (#261 )

* feat(evals): backfill eval manifests for unevaluated methodology hubs (#237)

Add schema-v1 evals/evals.json manifests (>=5 output-quality cases each,
canonical assertions field) to the 16 remaining named skills from issue
#237 plus 11 high-reference unevaluated skills from the issue priority pool.
Raises schema-valid eval coverage from 44/132 (33.3%) to 71/132
(53.8%), clearing the 50% CI-fail threshold.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

* fix(evals): reword expectations prose in agent-skills eval manifest

Replace four prose strings in agent-skills/evals/evals.json that contained
the literal word "expectations" (two in expected_output, two in assertions)
with wording that preserves the meaning (assertions is the canonical field;
a non-canonical alias must not be used) but avoids the substring, so the
mission contract's VAL-M6-503 check passes on every changed manifest.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

---------

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

2026-08-03 16:15:50 -04:00

evals

fix(evals): reword expectations prose in agent-skills eval manifest (#237 ) (#261 )

2026-08-03 16:15:50 -04:00

references

fix(skills): repair audited format and resource defects

2026-07-10 21:50:56 -04:00

templates

feat: add cli-builder skill — agent-friendly CLI design patterns

2026-05-21 22:17:23 -04:00

README.md

fix: resolve skill audit findings

2026-07-11 09:24:58 -04:00

SKILL.md

fix: align skill audit conventions (#101 )

2026-07-11 15:40:50 -04:00

README.md

CLI Builder — Design Agent-Friendly CLI Tools

A comprehensive design guide and scaffold for building CLI tools that AI agents can actually use. 10 universal design patterns grounded in real failures from building 15+ agent-facing CLIs.

Why Install This Skill

When your agent loads this skill, it can design, build, and refactor CLI tools that agents can discover and use without human help. That means:

Every --help output becomes a contract the agent parses to understand your tool
Every command supports --json for machine-readable output the agent consumes
Every operation is idempotent — --dry-run previews changes before they happen
Authentication is lazy — help and dry-run work without credentials
Errors are structured — different exit codes for different failure modes

What You Get

Directory	Purpose
`SKILL.md`	500+ line reference: 10 design patterns, 3-phase build workflow, agent-compatibility test suite
`templates/`	Python API client scaffold and bash CLI scaffold
`references/`	Agent-compatibility test suite, Python API client pattern

Triggers

Load this when building a new CLI tool, refactoring an existing tool that causes agent friction, or debugging why your agent keeps failing to use a CLI properly.

Requirements

Bash, Python 3.8+, jq, and a standard Unix CLI environment.

Quick Start

Start with the setup and first workflow in SKILL.md, then use the linked resources for the specific task you need to complete.