AGENT SKILL

garden-usage

Answer "what is this, and how do I use it?" about anything in the vibrobeast garden (a skill by any of its four names, a C4 tool by its plain or coded name, a C4 entity) in one plain sentence, then how to use it and where to read more. Use when someone asks what a skill or tool is, which skill fits a task, what a strange name means, "what is moon-bite", "what does nm1fl do", "which skill checks signatures", "how do I use the garden", or when acting as a support persona for someone with a simple plugin install and no C4 tree. When one word means two things here it says so (a SEAM) instead of choosing. Reads the registers and skill descriptions; never invents an answer.

License 许可
GPL-3.0
所属仓库
inputloop/garden
最近更新
2026-10-14
Stars
★ 0
Forks
0

01 前言 Front Matter

name
garden-usage
description
Answer "what is this, and how do I use it?" about anything in the vibrobeast garden (a skill by any of its four names, a C4 tool by its plain or coded name, a C4 entity) in one plain sentence, then how to use it and where to read more. Use when someone asks what a skill or tool is, which skill fits a task, what a strange name means, "what is moon-bite", "what does nm1fl do", "which skill checks signatures", "how do I use the garden", or when acting as a support persona for someone with a simple plugin install and no C4 tree. When one word means two things here it says so (a SEAM) instead of choosing. Reads the registers and skill descriptions; never invents an answer.

02 资源文件 8

03 SKILL.md 正文

garden-usage — say what a thing is, then how to use it

The rule this skill carries. Every thing in the garden has a handy sentence that says what it is. Give that sentence first, then how to use it, then its other names, then where to read more. Never invent a sentence: if the garden does not say what something is, say that, offer the closest names, and suggest writing the sentence (an entity's first line, a skill's description).

Look it up

sh scripts/whatis.sh NAME          every meaning NAME has here, one sentence each
sh scripts/whatis.sh NAME --json   the same, for a program
sh scripts/whatis.sh --list        every installed skill, one line each

It reads, first found first: the four-name register (C4 c/skillnames: label, persona, standard and pet names), the tool register (C4 c/names: plain and coded names), the skills installed beside this one, and C4 entities under Z/ (their first lines). It finds C4 at $C4_ROOT, else /f/claude/c4, else ~/mnt/c4. With no C4 tree (a simple plugin install), it answers from the installed skills alone, and that is still a full answer for anything the plugin ships.

A skill that is soft here (a folder under a SOFT-SKILLS root, served live, not installed) is answered with the line that reads it: soft_skill_read NAME, the mentcached server's tool. --list marks those (soft). Its soft roots: $GARDEN_SOFT (colon-separated) if set, else $SOFT_SKILLS, ~/.mentcached/SOFT-SKILLS, the SOFT-SKILLS beside $MENTCACHED_SEAT, and the SOFT-SKILLS folder beside the installed skills. It does not read the softskills.roots preference; the server does, so soft_skills_list is the fuller answer (ERRATA E3, 2026-09-29).

Answer in this order

  1. The sentence, as the garden has it. If the name was a persona, standard or pet name, say which skill it names ("moon-bite is eclipse-pass").
  2. How to use it: a skill loads when you ask for it by any of its names or describe its task; a tool runs with --help first.
  3. Its other names, so the person can use whichever they like (nm1fl show lists all four sets; ~/.config/polygram/flavor picks one for minted editions).
  4. Where to read more: the skill's SKILL.md, the tool's header, the entity file.

Seams, said out loud

A name that means two things here is reported as a SEAM with both meanings. The known near-seam is the word usage: the C4 tool registered as usage (us1ct) counts token usage, grouped by skill, tool, sub-agent or turn, while this skill, garden-usage, is about how to use things. When someone says "usage", ask which they mean; do not guess.

When you are a support persona

Speak in plain words, one step at a time, and assume nothing about the person's setup beyond what they say. If they have only the plugin, answer from the installed skills and say that the fuller registers live in a C4 tree they do not need. If an answer needs a tool they do not have, say so and give the nearest skill instead.

How this skill can fail (falsifiers)

  • An invented answer. fails if a printed sentence is not in the skill's description or the register row it came from; check: grep -F '<sentence>' <skill>/SKILL.md "$C4_ROOT/c/skillnames" finds it.
  • A seam hidden. fails if "usage" is answered with one meaning; check: sh scripts/whatis.sh usage prints only the tool (observed 2026-09-27), so the ask must come from you, not the script.
  • Plugin-only gap. fails if, with no C4 tree, a shipped skill's name exits 1; check: env -u C4_ROOT HOME=/tmp sh scripts/whatis.sh candor-gate; echo $? prints 0.

<!-- footer: minted by bin/ft1mt from conventions/house.env and conventions/FOOTERS.org; edit those, not this --> Version 1.1.0: edition revised from 1.0.1 on 2026-10-10; spine: 2026-09-27.

Copyright 2026 Corwin Brust corwin@bru.st and Contributors; CC-BY-SA4: https://creativecommons.org/licenses/by-sa/4.0/ (scripts GPL-3.0-or-later); Mentat (for Corwin; claude-opus-5-5) <!-- /footer -->

04 同仓库更多 Skills