Skip to main content
AI/MLjmagly

prose-install

Install OpenProse for AIWG when not found. Tries `npx skills add`, falls back to git clone, then saves the resolved path to .aiwg/config.json.

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--prose-install
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-install/SKILL.md -o .claude/skills/prose-install.md

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

Prose Install Skill

You install OpenProse for AIWG use when /prose-detect reports no installation is found.

Triggers

  • Invoked by /prose-detect when all detection signals fail
  • "install prose" / "install openprose"
  • "prose install"
  • "set up prose"

Behavior

Step 1: Confirm with User

Before installing, ask:

OpenProse is not installed. Install it to ~/.aiwg/prose/ so AIWG prose skills can use it?

  Primary method:   npx skills add openprose/prose
  Fallback method:  git clone https://github.com/openprose/prose ~/.aiwg/prose

[Y/n]

If the user declines, stop and report:

Installation cancelled. Set PROSE_ROOT to an existing OpenProse installation to proceed.

Step 2: Try Primary Method

npx skills add openprose/prose --target ~/.aiwg/prose

If this succeeds and ~/.aiwg/prose/skills/open-prose/prose.md exists, proceed to Step 4.

Step 3: Fallback — git clone

If npx fails (not available or package not found):

git clone --depth=1 https://github.com/openprose/prose.git ~/.aiwg/prose

Step 4: Validate Installation

Check that required files are present:

ls ~/.aiwg/prose/skills/open-prose/prose.md
ls ~/.aiwg/prose/skills/open-prose/forme.md

If either is missing, report failure:

Installation failed: prose.md or forme.md not found at ~/.aiwg/prose/skills/open-prose/.
Try cloning manually: git clone https://github.com/openprose/prose.git ~/.aiwg/prose

Step 5: Save to Config

Write the resolved path to .aiwg/config.json:

{
  "prose": {
    "path": "~/.aiwg/prose/skills/open-prose",
    "installedVia": "npx|git-clone",
    "installedAt": "2026-04-02T00:00:00Z"
  }
}

Step 6: Report Success

## OpenProse Installed

**Location**: ~/.aiwg/prose/skills/open-prose
**Method**: npx skills add | git clone
**prose.md**: present
**forme.md**: present
**Config saved**: .aiwg/config.json → prose.path

All prose-integration skills are now ready to use.

Updating an Existing Installation

If OpenProse is already installed and the user wants to update:

cd ~/.aiwg/prose && git pull origin main

Or use /prose-setup which handles both install and update.

Model

This skill runs on Haiku — it's confirmation prompts and shell commands.

References

  • @$AIWG_ROOT/agentic/code/addons/prose-integration/README.md — prose-integration addon overview
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/human-authorization.md — Explicit user confirmation required before installing
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Validate installation after each method before declaring success
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference for AIWG addon configuration