Builder
SkillProductivityAuthor and refine reference skills, task-style command skills, and path-scoped rules using one repository-grounded workflow. TRIGGER when: asked to create, build, scaffold, convert, review, or update a skill, command, workflow, rule, coding standard, or contextual instruction. Skills are the canonical primitive for a reusable role, procedure, or body of judgment — there is no project-agent artifact type.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Builder skill
What this skill tells your AI
The instructions your AI receives, as published by mifunedev/agro in .agro/skills/builder/SKILL.md and read by ahel’s review.
Build one artifact through the matching type reference. Run inline and inherit the session model; do not fork or override the model unless the artifact being authored has an independently justified need.
Arguments received: $ARGUMENTS
Dispatch
-
Treat the first whitespace-delimited argument as
TYPEand the remainder as the artifact name, request, or path. -
Accept exactly these types:
Type Read and follow skillreferences/skill.mdcommandreferences/command.mdrulereferences/rule.md -
If
TYPEis missing or unknown, or the remaining request is empty or only whitespace, print the following and stop without reading type references or modifying files:Usage: /builder <skill|command|rule> <name-or-request>agentis not an artifact type. A reusable role, procedure, or specialist judgment is authored as a skill; a bounded isolated worker context is an execution choice made by/delegate, not a repository artifact. -
Read the selected reference completely, then execute its protocol against the remainder of
$ARGUMENTS. The selected reference is authoritative for artifact shape and type-specific validation.
Shared protocol
Apply these steps for every valid type before the selected reference's type-specific steps.
1. Discover local authority
- Find and read applicable
AGENTS.mdandCLAUDE.mdfiles from repository root through the target directory. More local instructions win; in one directory,AGENTS.mdis canonical. - Identify the source-of-truth artifact directory. In Open Harness and equipped
projects, edit
.agro/skills/; provider directories such as.claude/,.codex/, and.pi/are generated or symlinked exposure surfaces. - Outside an Open Harness layout, follow the target project's documented canonical
path rather than creating
.agro/speculatively. - Inspect two or three nearby artifacts of the same type. Reuse their naming, frontmatter, structure, tone, and validation conventions.
- Search for an existing artifact with the same purpose. Prefer a focused update or explicit consolidation over a near-duplicate.
- Consult compiled harness patterns before proposing a change. Run
/wiki query <artifact-name-or-subsystem> --patternsand read what it returns: each page records a failure mode, its root cause, and a workaround this harness already paid for. Cite the motivating[[pattern-...]]slugs in the report. - Read
.agro/evals/decisions/skill-impact.mdfor prior proposals against the same target. Do not re-propose a change recorded there asREJECTEDunless new evidence contradicts the recorded validation; when you do, cite the prior record id.
2. Define the contract
Before editing, state internally:
- the artifact's one-sentence purpose and concrete triggers;
- who invokes or consumes it;
- what is in scope, out of scope, and considered done;
- the minimum tools, context, side effects, and supporting resources required;
- which behavior is repository-specific and must be grounded in inspected files.
Ask a question only when unresolved ambiguity would materially change the artifact or create unsafe side effects. Otherwise use the request and repository evidence.
3. Author narrowly
- Use lowercase kebab-case names and one artifact per coherent concern.
- Put matching and trigger information in frontmatter, not only in the body.
- Use imperative, operational language. Remove generic expertise prose that does not change behavior.
- Prefer the least privilege and smallest context footprint that completes the job.
- Cite real local paths and commands only after verifying them.
- Do not modify unrelated files, generated provider mirrors, or user work in the working tree.
4. Validate and report
- Validate frontmatter delimiters and required fields without assuming optional YAML libraries are installed.
- Check every referenced path, invocation, tool, and supporting file.
- Enforce the selected reference's size, safety, and semantic checks.
- When
.agro/scripts/link-providers.shexists and canonical.agro/primitives were changed, runbash .agro/scripts/link-providers.sh --check. - Run
git diff --checkwhen inside a Git worktree. - Report the files created, updated, or removed; the resulting invocation or loading behavior; key design choices; and validation evidence. Never claim a check ran if it did not.
- Append a
PROPOSEDrecord to.agro/evals/decisions/skill-impact.mdwhen a skill edit lands: the nextSI-nnnnid, the one-sentence proposal, the single target artifact, the motivating pattern slugs, and the unified diff scoped to that target path.motivating patterns: none (direct request)is a legitimate value — record it rather than inventing a pattern to cite. Stage the ledger (.agro/evals/decisions/is tracked, so a plaingit add) and report the allocated id. Never edit an existing record.
Signals
- GitHub stars
- 38
- Forks
- 3
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
builder- Source
- github.com/mifunedev/agro