Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (subcode-skills) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Subcode Skills

Portable Claude skills for enhanced developer experience

# Install subcode skills in your repository
npx subcode-skills install

What is this?

Subcode Skills is a collection of portable tools designed to supercharge your development workflow with Claude. Each skill provides Claude with specialized knowledge, scripts, and best practices for specific tasks.

Read the full vision: VISION.md

Quick Start

Interactive Installation

npx subcode-skills install

Headless/CI Installation

npx subcode-skills install --yes

The installer will:

Check for required dependencies (Bun)
Let you select which skills to install
Set up the .subcode/ directory in your repo
Install selected Claude skills to .claude/skills/

Available Skills

subcode-worktrees

Git worktree management with best practices.

Features:

Create worktrees in a standardized location (.subcode/worktrees/)
Auto-install dependencies in new worktrees
Copy environment files automatically
List, remove, and prune worktrees
Structured JSON output for Claude integration

Commands:

# Create a new worktree
bun run .claude/skills/subcode-worktrees/src/create.ts --name feature-auth

# List all worktrees
bun run .claude/skills/subcode-worktrees/src/list.ts

# Remove a worktree
bun run .claude/skills/subcode-worktrees/src/remove.ts --name feature-auth

# Clean up stale worktrees
bun run .claude/skills/subcode-worktrees/src/prune.ts

Requirements

Bun (will be installed automatically if missing)
Git (for worktree operations)
gum (optional, for fancy UI - falls back to simple prompts)

How It Works

Directory Structure

After installation, your repo will have:

your-repo/
├── .subcode/                    # Subcode tooling directory
│   ├── .gitignore               # Ignores worktrees, logs, etc.
│   ├── config.json              # Subcode configuration
│   └── worktrees/               # Git worktrees live here
│       └── feature-branch/
├── .claude/
│   └── skills/
│       └── subcode-worktrees/   # Installed skill
└── ...your code

Configuration

.subcode/config.json:

{
  "$schema": "https://raw.githubusercontent.com/subcode-labs/subcode-skills/main/schemas/config.schema.json",
  "version": "1.0.0",
  "worktrees": {
    "defaultBaseBranch": "main",
    "autoInstallDeps": true,
    "copyEnvFiles": true,
    "packageManager": "auto"
  }
}

Using with Claude

Once installed, Claude will automatically use these skills when relevant. Just ask:

"Create a new worktree for the auth feature"
"List my current worktrees"
"Clean up old worktrees"
"Remove the feature-auth worktree"

Claude will use the skill scripts and follow best practices automatically.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE

Read the full vision | Report an issue