Example minimal

Skill justinramos101/agent-skill-kit/docs/templates/example-minimal

Battle-tested Agent Skills for coding agents — source-grounded, failure-driven heuristics that audit and design real surfaces. Install with npx skills.

Install

npx -y skills add justinramos101/agent-skill-kit --skill example-minimal

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Template contract for this repository: the minimum artifacts every skill must ship (SKILL.md, skill.json, evals/*) so static checks catch a skill templated from it that bypasses gates. Hidden from `npx skills add . --list` by `metadata.internal: true`. Do not delete.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.9 KB, as published. Nobody here has run it

Example minimal skill

This folder exists as the template contract for this repository: it carries the minimum required artifacts (SKILL.md, skill.json, and evals/*) so contributors can't accidentally template a new skill that bypasses gates.

New skills templated from this folder follow the house style: flat (no routing CSVs), AFK-default (no mode menus or wait-for-user steps — run to completion and state assumptions), SKILL.md under ~500 words with must-not-miss invariants inlined, and at most a few distilled reference files. Static checks use the shared flat shape in scripts/check-skill-static.py.

It is marked metadata.internal: true, so it is hidden from npx skills add . --list unless INSTALL_INTERNAL_SKILLS=1 is set.

When to use

Never in production installs. Use only when validating template/gate behavior, or as the source you copy when starting a new skill (see step 1 below).

Steps

Copy this directory to skills/my-real-skill/ and edit SKILL.md — rewrite the frontmatter description for the routing decision: intent triggers plus capability-based anti-triggers ("Do NOT use for X" — describe the excluded work, don't name a sibling skill that may not be installed alongside yours; see docs/skill-authoring-principles.md) — or run npx skills init my-real-skill and move the result under skills/.
Do not delete docs/templates/example-minimal/ — per AGENTS.md Rule 3, it is the template contract and must continue to exist so future skills can be templated from it. Living under docs/ keeps it out of the install lanes.