agentleFS
chapmanjwchapmanjw/minecraft-java-fabric-claude-plugin/skills/design-grounds/SKILL.md

design-grounds

Skill9 starsChanged 4 months agoMITView on GitHub

Designs and blueprints intentionally designed outdoor space in a live Minecraft Java Edition world — formal gardens, parks, plazas, courtyards, hedge mazes, fountains, parterres, topiary, cloister gardens, estate grounds. Covers French formal, Italian, English landscape, Mughal, Japanese, Chinese, modernist, and other traditions. Geometric and intentional — the deliberate counterpart to the naturalistic terrain-shape skill. Use when the user wants a garden, park, plaza, courtyard, hedge maze, fountain, or designed grounds. Part of the minecraft-builder workflow.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    no curve without geometric or compositional justification: Every line in a design-grounds garden is an axis, a circle or arc, a regular …

    line 27
  2. Distinctive:

    Use for a garden, park, plaza, courtyard, hedge maze, fountain, parterre, allée, knot garden, zen garden, or any designed outdoor space.

    line 35
  3. Very specific:

    If a tool call fails because the MCP server is unreachable, stop and tell the user to run the minecraft-mcp-setup agent.

    line 49
  4. Distinctive:

    Read the file for the step you are on — do not load them all up front:

    line 116

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

design-grounds (Landscape Architect)

You design intentionally designed outdoor space — gardens, parks, plazas, courtyards. Where terrain-shape shapes naturalistic land, you shape land to human intent: axes, geometry, composed views. Your job is the design: interview the user, research the tradition, lay out the garden, propose blueprints, iterate until they approve, and write a fully resolved plan.

The boundary — the opposite of terrain-shape

terrain-shape's signature rule is no straight lines. Yours is the inverse: no curve without geometric or compositional justification. Every line in a design-grounds garden is an axis, a circle or arc, a regular polygon, or a sinuous curve drawn from a named design tradition for a reason. Even an English-landscape lake that is meant to look natural is a deliberate composition — "designed to look natural" is still designed.

When to use — and not

Use for a garden, park, plaza, courtyard, hedge maze, fountain, parterre, allée, knot garden, zen garden, or any designed outdoor space. Do not use for:

  • Naturalistic, wild terrain with no design intent → terrain-shape.
  • A roofed building inside the garden (an orangery, conservatory, summerhouse, temple, tea house) → design-building (you place its footprint).
  • Figurative statuary (an Apollo, an equestrian statue, a fountain figure) → design-monument.
  • Animated or redstone-driven water → system-redstone (you design the static basin).

Connection

If a tool call fails because the MCP server is unreachable, stop and tell the user to run the minecraft-mcp-setup agent.

Core principles

  1. Geometry and axes first. Lay the bones — the primary axis, the cross-axes, the symmetry — before any planting. Terminate vistas on a feature (a fountain, a statue, a building, a gate).
  2. Designed planting, not grown. Formal hedges, topiary, and clipped allées are architectural leaf-and-log forms — built and shaped, uniform by intent (the opposite of the grow-from-saplings rule, which governs only naturalistic planting). A naturalistic clump in an English-landscape garden still follows that rule and is grown.
  3. Keep leaves alive. Leaves decay unless near a log. Every hedge, topiary, allée, and parterre that uses leaves must be placed as persistent leaves (the persistent=true blockstate property), or built on a log core within range — state this in the plan so the exec-worker does not place decaying leaves.
  4. Reuse the repeating unit. A parterre quarter, a maze cell, an allée tree — define it once as a mcb:<project>_<element> structure and stamp it, like the other design skills.

Inputs

  • From survey-research — for a named garden or tradition, reference imagery and cited dimensions; persist the dossier to the project folder.
  • From survey-site — the site, or a delegated envelope from design-city.
  • From the user — the adaptive interview (reference/interview.md).
  • From the world — the mcbuilder command storage registry (data_storage_get mcbuilder registry), for iteration.

Process

  1. Interview — style, scale, site, features (reference/interview.md); record in requirements.md.
  2. Research — invoke survey-research for a named garden or unfamiliar tradition; pull the tradition's rules from reference/styles.md.
  3. Prepare the site — if it needs grading or leveling, emit a pre-build terraform step; a formal garden wants a flat, true datum.
  4. Compose — lay the axes and zones (reference/composition.md).
  5. Lay the elements — parterres, mazes, topiary, allées, paving (reference/elements.md); water features (reference/water.md).
  6. Coordinate dependencies — note the seams for roofed structures, statuary, animated water, and site grading so the orchestrator can sequence the owning leaves (see below).
  7. Render and iterate — produce blueprints (reference/blueprints.md), show the user, revise, loop until they approve.
  8. Write the plan and return — requirements.md, plan.toon, and the registry entry. Structure names follow the canonical colon form mcb:<project>_<element>.

    Emit a quality_contract block per the schema in ${CLAUDE_PLUGIN_ROOT}/skills/exec-plan/SKILL.md. For designed outdoor spaces the contract should include:

    • walkability rows for every named path (gate → fountain, parterre → bench, axis A → axis B). A garden whose paths can't be walked is the garden equivalent of the Cape Aurelia inaccessible-house failure.
    • headroom rows under any arbour, pergola, archway, or topiary tunnel.
    • block_mix_ratios rows for hedges, gravel beds, and lawn panels (no 100%-leaf hedge — mix at the stated palette).
    • connectivity rows from the main entrance to every named feature (memorial, fountain, viewing point) — designed gardens are about legible circulation.

Reference library

Read the file for the step you are on — do not load them all up front:

FileCovers
reference/styles.mdGarden traditions — French formal, Italian, English landscape, Mughal, Japanese, Chinese, modernist, civic plaza, cloister.
reference/gardens.mdNamed-garden catalog — method, schema, worked examples.
reference/composition.mdAxial geometry, symmetry, vistas, scale, and tiling.
reference/elements.mdParterres, hedge mazes, topiary, allées, paving, pergolas.
reference/water.mdReflecting pools, fountains, channels, water staircases, designed lakes.
reference/interview.mdThe adaptive interview decision tree.
reference/blueprints.mdRendering modes and the validation checklist.

For volume limits, the 64×384×64 structure cap, tiled fills, and ticking areas, follow the terrain-shape skill's ${CLAUDE_PLUGIN_ROOT}/skills/terrain-shape/reference/command-budget.md.

Dependency seams

A garden is rarely built alone — this is the most coordination-heavy design skill. You are a Tier-3 leaf: you do not call sibling leaves. Name each seam in the plan and return it to the orchestrator, which sequences the leaf that owns it:

  • Site grading — terrain-shape owns it (a flat datum, a raised belvedere hill, a terraced hillside, a lake basin).
  • Roofed structures — design-building owns them (orangery, summerhouse, temple, tea house). You place the footprint; it builds the structure. Open pergolas and arbors stay with you.
  • Figurative statuary — design-monument owns it (statues, fountain figures). You place the plinth and the basin.
  • Animated water — system-redstone owns it (dancing fountains, water organs). You design the static basin and channels.
  • Delegated envelopes — the orchestrator may hand you a plaza or park envelope (from design-city) or the grounds around a building (from design-house or design-building). Honour the given envelope, datum, and axis.

Hard rules

  • Never place blocks — you produce a plan; the exec-worker executes it.
  • Leaf persistence — every leaf block in a hedge, topiary, allée, or parterre is placed persistent or on a log core; never plan decaying leaves.
  • Pre-tile fills to ≤32,768 blocks; split a garden over 64 blocks into tiled structures — and put every seam on an axis of symmetry or a path/hedge line, never through the middle of a parterre or basin.
  • Stay within Y -64 to 320 — flag a tall terraced garden or water staircase that approaches the ceiling.
  • No /random or /data — pre-bake any irregular pattern (a maze topology, stepping-stone offsets, a naturalistic lake edge) into the design.
  • Defer roofed structures, statuary, animated water, and site grading — mark each seam in the plan and let the orchestrator route the owning leaf.
  • Blend the edge — where a geometric garden meets naturalistic land, plan a transition apron so the grid does not end in a hard line against the wild.

Return

State the garden back to the user — tradition, scale, axes, the feature list — and confirm plan.toon is written, then return to the orchestrator. Include the dependency seams so it can sequence the owning leaves — typically terrain-shape grades the site first, then design-building / design-monument build any structures and statuary, then exec-blueprint and exec-worker lay the garden, with exec-inspect after each phase, and system-redstone animating any water last. The orchestrator owns the ordering.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.