Skip to main content
AI/MLjmagly

prose-setup

Clone or update the OpenProse repository to ensure AIWG prose tools hook into the latest version of the specification and examples

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--prose-setup
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/prose-integration/skills/prose-setup/SKILL.md -o .claude/skills/prose-setup.md

Drops the SKILL.md into .claude/skills/prose-setup.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Prose Setup Skill

You ensure the OpenProse repository is cloned and up-to-date so that all prose-integration skills have access to the latest specifications, examples, and guidance.

Triggers

  • "setup prose" / "install prose" / "install openprose"
  • "update prose" / "update openprose"
  • "clone prose repo"
  • "ensure prose is available"
  • "prose setup"

Behavior

Step 1: Check Current State

Check if OpenProse is already cloned:

# Check default location
ls /tmp/prose/skills/open-prose/prose.md 2>/dev/null

# Check configured location (from addon config proseRoot)

Step 2: Clone or Update

If not present — clone from GitHub:

git clone https://github.com/openprose/prose.git /tmp/prose

If already present — pull latest:

cd /tmp/prose && git pull origin main

Step 3: Verify Installation

After clone/update, verify key files exist:

File Purpose Required
skills/open-prose/prose.md Prose VM specification Yes
skills/open-prose/forme.md Forme Container specification Yes
skills/open-prose/guidance/patterns.md Design patterns Yes
skills/open-prose/guidance/antipatterns.md Antipatterns guide Yes
skills/open-prose/guidance/tenets.md Design tenets Yes
skills/open-prose/examples/ Example programs (50+) Yes

Step 4: Report Version

cd /tmp/prose && git log -1 --format="%H %ci %s"

Step 5: Output Summary

## OpenProse Setup Complete

**Location**: /tmp/prose
**Version**: {commit hash} ({date})
**Latest commit**: {subject}

### Verified Files
- [x] prose.md (Prose VM spec)
- [x] forme.md (Forme Container spec)
- [x] guidance/ (patterns, antipatterns, tenets)
- [x] examples/ ({count} examples)

### Available Skills
All prose-integration skills now have access to the latest OpenProse specification:
- `/prose-reader` — parse contracts
- `/prose-run` — execute programs
- `/prose-validate` — validate grammar
- `/forme-manifest` — generate wiring manifests

Custom Install Location

If the user wants Prose installed somewhere other than /tmp/prose, they can configure it:

# In aiwg.yml
addons:
  prose-integration:
    proseRoot: /path/to/prose/skills/open-prose
    proseRepoPath: /path/to/prose

The clone target is proseRepoPath (repo root), and proseRoot is {proseRepoPath}/skills/open-prose.

Auto-Setup

Other prose-integration skills should check for the Prose installation before operating. If not found, suggest running /prose-setup first:

OpenProse not found at /tmp/prose/skills/open-prose/prose.md

Run `/prose-setup` to clone the latest OpenProse repository, or configure
a custom path in aiwg.yml under addons.prose-integration.proseRoot

Model

This skill runs on Haiku — it's just git operations and file checks.

References

  • @$AIWG_ROOT/agentic/code/addons/prose-integration/README.md — prose-integration addon overview
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify installation state before cloning or pulling
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/human-authorization.md — Confirm custom install location with user when non-default path requested
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference for AIWG addon configuration