wordspace

SKILL.md

Wordspace

Wordspace is a CLI tool that bootstraps project workspaces with workflows — reusable .prose programs fetched from GitHub.

When to activate

Activate this skill when the user:

Wants to set up a new wordspace project

Wants to browse, search, or add workflows

Mentions "wordspace" by name

Asks about available workflows or how to get new ones

Commands

wordspace init

Bootstrap a new project in the current directory. Runs three steps:

Workflows — Fetches available .prose workflows from GitHub and presents an interactive picker. The user selects which ones to download. In CI (non-TTY), all workflows are downloaded automatically.

Claude settings — Creates .claude/settings.local.json with base permissions (curl, python3, WebFetch, WebSearch).

Directories — Creates the output/ directory.

Use --force to re-download workflows that already exist locally.

wordspace search [query]

List all available workflows from the remote repository. Optionally filter by a substring query.

wordspace search            # list all
wordspace search pulse      # filter by "pulse"

wordspace add <name> [...]

Download one or more specific workflows by name. Automatically appends .prose if missing.

wordspace add x-daily-pulse
wordspace add x-daily-pulse x-weekly-report
wordspace add x-daily-pulse --force    # overwrite existing

Project structure after init

project/
├── .claude/
│   └── settings.local.json    # Claude permissions
├── workflows/
│   └── *.prose                # downloaded workflow files
├── output/                    # working directory for outputs
└── skills/
    └── wordspace/
        └── SKILL.md           # this file

Workflow picker (during init)

When running wordspace init, the CLI presents a numbered list of available workflows. The user can respond with:

all or press Enter — download everything

none or 0 — skip workflow download

1,3,5 — pick specific numbers

1-3 — pick a range

1,3-5,7 — mix of both

Installation

npx wordspace init

Or install globally:

npm i -g wordspace
wordspace init