shawn-sandy/plans-open

plans-open

Open the existing index.html gallery directly — no file scanning, no template substitution, no write operations. If index.html does not exist, prompt the user to run /plan-agent:plans-library first.

This skill generates no output, so it has no output check of its own. The card-count check lives in plan-agent:plans-library, which writes the gallery.

Step 1 — Resolve the plans directory

Read plansDirectory following Claude Code's settings precedence — project-local .claude/settings.local.json, then project .claude/settings.json, then global ~/.claude/settings.json; the first that sets it wins. Fall back to ${PWD}/docs/plans if none do.

PLANS_DIR=$(python3 - <<'EOF'
import json, os, sys
# Claude settings precedence: project-local → project → user-global
candidates = (
    os.path.join(os.getcwd(), '.claude', 'settings.local.json'),
    os.path.join(os.getcwd(), '.claude', 'settings.json'),
    os.path.join(os.path.expanduser('~'), '.claude', 'settings.json'),
)
for path in candidates:
    try:
        v = json.load(open(path)).get('plansDirectory', '').strip()
        if v:
            print(v); sys.exit(0)
    except Exception:
        pass
print(os.path.join(os.getcwd(), 'docs', 'plans'))
EOF
)

Step 2 — Check for index.html

test -f "$PLANS_DIR/index.html"

If index.html does not exist, output:

"No gallery found. Run /plan-agent:plans-library to build it first."

STOP.

Step 3 — Open in browser

GALLERY_PATH=$(realpath "$PLANS_DIR/index.html" 2>/dev/null || echo "$PLANS_DIR/index.html")
open "$GALLERY_PATH" 2>/dev/null || xdg-open "$GALLERY_PATH" 2>/dev/null || true

Tell the user:

"Plans gallery opened: <PLANS_DIR>/index.html"

Step 4 — Stop

STOP. Do not run git commands or invoke other skills after opening the gallery.