forked from bchanot/claude
bastien
0d035fcab6
No profile selected (.active-profile absent, empty or legacy "none") now means the `full` profile is in force: DEFAULT_PROFILE declared once in lib/profile.sh, resolved by active_profile(); the statusline reads the constant and shows `full` instead of `?`; `gstack off` trims to it instead of erroring. `reset` goes to the default profile (= `set full`: enables its list, parks any non-listed gstack or managed item). `current` names the active label and scores that profile only, saying `default — not applied yet` until a set/apply/reset wrote the cache; the "none" sentinel and the cross-profile best-guess scan are gone (they keyed on the parked-gstack count, which says nothing under BDR-030's gstack-off default). Hermetic suite lib/tests/profile-default.test.sh (29 checks) seeds gstack as OFF like a real tree. Citers updated: profile SKILL, Makefile help, plugin-advisor PROFILE line + reset paragraph, toggle-external header.
157 lines
7.9 KiB
Markdown
157 lines
7.9 KiB
Markdown
---
|
|
name: profile
|
|
description: |
|
|
Partition Claude skills by purpose: design, dev, qa, audit, minimal.
|
|
Toggles symlinks between skills/ and skills-disabled/ to keep only
|
|
the skills relevant to the current kind of work.
|
|
Trigger: "profile", "skill profile", "design profile", "qa profile",
|
|
"switch to design", "set profile", "active profile", "quel profil",
|
|
"profil design", "active les skills design", "désactive gstack",
|
|
"réduire le bruit gstack".
|
|
argument-hint: list | show <name> | current | apply <name> | set <name> | reset | gstack on|off | diff <a> <b>
|
|
allowed-tools:
|
|
- Bash
|
|
- Read
|
|
---
|
|
|
|
# profile
|
|
|
|
Activate a curated subset of skills for a specific kind of work — instead of
|
|
carrying every gstack + personal skill in every session.
|
|
|
|
## When to invoke
|
|
|
|
- User asks to switch profile (`set design`, `profile dev`, `quel profil actif`).
|
|
- User wants to see what's in a profile (`profile show qa`).
|
|
- User wants to compare profiles (`profile diff design qa`).
|
|
- User asks to "reduce gstack noise" or "only design skills".
|
|
|
|
## Profiles available
|
|
|
|
| Profile | Use case |
|
|
|------------|----------|
|
|
| `web` | Public website work — frontend + content + light dev |
|
|
| `seo` | SEO + GEO + W3C audit — search/AI indexability + standards |
|
|
| `web-full` | Production website end-to-end — `web` + `seo` combined |
|
|
| `full` | Maximum — web-full + plan + dev for `/init-project` MVP pipeline |
|
|
| `backend` | Backend / API / system dev — no design, no SEO |
|
|
| `design` | Visual QA, design systems, mockups, polish |
|
|
| `dev` | Daily code work — features, fixes, refactor, ship (any stack) |
|
|
| `qa` | Site testing, perf, canary, validation |
|
|
| `audit` | Comprehensive audit — security + SEO + GEO + W3C + perf + health |
|
|
| `minimal` | Strip all gstack skills (quiet session) |
|
|
|
|
## Mechanism
|
|
|
|
Each profile is a plain-text file under `lib/profiles/<name>.profile` that
|
|
lists items + types:
|
|
|
|
| Type | Toggle mechanism |
|
|
|-------------------------|------------------|
|
|
| `gstack` | symlink move skills/ ↔ skills-disabled/gstack__\<name\> |
|
|
| `personal` | symlink move skills/ ↔ skills-disabled/\<name\> (no prefix) |
|
|
| `external` | symlink move skills/ ↔ skills-disabled/\<name\> |
|
|
| `plugin@<marketplace>` | `claude plugin enable\|disable <name>@<marketplace>` (auto) |
|
|
| `mcp` | advisory — prints manual `claude mcp add …` command (no server is managed today: `MANAGED_MCPS` is empty since 21st.dev moved to a CLI) |
|
|
| `cli` | advisory only — reports installed/not-installed |
|
|
|
|
**Always-on plugins** (`security-guidance`, `superpowers`) are
|
|
protected — `set` will refuse to disable them even if the profile omits them.
|
|
**Managed plugins** that `set` may disable when not in profile:
|
|
`ui-ux-pro-max@ui-ux-pro-max-skill`, `plugin-dev@claude-code-plugins`,
|
|
`pr-review-toolkit@claude-code-plugins`. Other plugins are never auto-toggled.
|
|
**Managed externals** (`emil-design-eng`, `frontend-design`,
|
|
`design-motion-principles`, `impeccable`, and the five 21st design skills
|
|
`21st-ui-build`, `21st-ui-explore`, `21st-ui-review`, `21st-cli-use`,
|
|
`21st-ai`) follow the same symmetry (BDR-079): `set` enables them when the
|
|
profile lists them (from parked state, or from `skills-external/` if the
|
|
symlink never existed) and parks them when it does not — e.g. `set backend`
|
|
after design work turns emil and the 21st pack off. `darwin-skill`,
|
|
`21st-registry`, `21st-design-sync` and any other unlisted external are never
|
|
auto-touched. gstack works the same
|
|
all the way down: a profile listing gstack skills while the whole pack is
|
|
off (via `toggle-external.sh`) re-enables JUST those skills on demand.
|
|
|
|
**Default profile**: `full` is in force whenever `.active-profile` is
|
|
absent, empty, or the legacy `none` (statusline, `current`, `gstack off`,
|
|
`reset` all resolve it the same way). `reset` applies it (`set full`,
|
|
exclusive); a fresh `make plugin` applies it too when nothing has ever
|
|
been selected.
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
# List available profiles
|
|
bash "$HOME/.claude/lib/profile.sh" list
|
|
|
|
# Show profile contents + per-skill status
|
|
bash "$HOME/.claude/lib/profile.sh" show <name>
|
|
|
|
# Report the active profile (label + match %)
|
|
bash "$HOME/.claude/lib/profile.sh" current
|
|
|
|
# Enable skills in profile (additive — keeps others enabled)
|
|
bash "$HOME/.claude/lib/profile.sh" apply <name>
|
|
|
|
# Enable only skills in profile (disables non-listed gstack skills)
|
|
bash "$HOME/.claude/lib/profile.sh" set <name>
|
|
|
|
# Go to the default profile (full) — exclusive, same as `set full`
|
|
bash "$HOME/.claude/lib/profile.sh" reset
|
|
|
|
# Toggle gstack only, keeping the active-profile label intact
|
|
bash "$HOME/.claude/lib/profile.sh" gstack on # restore parked gstack skills on top of the current profile
|
|
bash "$HOME/.claude/lib/profile.sh" gstack off # disable gstack skills not in the active profile
|
|
|
|
# Compare two profiles
|
|
bash "$HOME/.claude/lib/profile.sh" diff <a> <b>
|
|
```
|
|
|
|
## Execution
|
|
|
|
Run `lib/profile.sh` with the user's arguments. If user passed nothing, default
|
|
to `list`. If user named a profile without a verb (e.g. "profile design"),
|
|
treat it as `set <name>` — but confirm first because `set` disables other gstack
|
|
skills.
|
|
|
|
```bash
|
|
bash "$HOME/.claude/lib/profile.sh" $ARGUMENTS
|
|
```
|
|
|
|
## Failure modes
|
|
|
|
| Trigger | First move | If still stuck |
|
|
|---|---|---|
|
|
| `lib/profile.sh` absent (foreign machine, links broken) | `test -f "$HOME/.claude/lib/profile.sh"` before any verb; missing → propose `bash link.sh` from the config repo | STOP — never hand-move symlinks to emulate the script |
|
|
| Unknown profile name (rc=1, `✗ Profile not found`) | Show `list` output + the closest existing name ("`desing` → did you mean `design`?") | Let the user pick — never guess-and-`set` |
|
|
| Unknown verb (rc=1 + usage) | Re-map the request to the argument-hint verbs, retry once | Show usage, ask |
|
|
| `set`/`apply` exits nonzero MID-TOGGLE (permission, plugin CLI failure) | State may be PARTIAL. Run `current` to show what actually took; name the failed item from the script's output | run `current`, then re-run `set <name>` or `reset` (both are full exclusive applies, not an always-safe undo) |
|
|
| Plugin/MCP leg fails (marketplace/network) while symlink leg succeeded | Report the split state explicitly + print the manual `claude plugin`/`claude mcp` command for the failed leg | — |
|
|
| `current` names a profile other than the one just set | Cache (`.active-profile`) was written by another tool or hand-edited — show the raw script output to the user | Never hand-patch `.active-profile` — re-run `set <name>` (or `reset`) to force it back |
|
|
|
|
## Output policy
|
|
|
|
- After `set` / `apply` / `reset` / `gstack on|off`: show the count of skills
|
|
moved + tell the user to start a new Claude session to pick up the changes
|
|
(Claude scans `skills/` at session start).
|
|
- After `current`: report the active profile + match %; `default — not
|
|
applied yet` means the default profile is in force but not yet applied —
|
|
point the user at `reset`.
|
|
- After `show`: render the grouped output directly — no extra commentary unless
|
|
the user asks.
|
|
|
|
## Tradeoffs to mention if asked
|
|
|
|
- gstack skills still depend on `~/.claude/skills/gstack/bin/` for telemetry,
|
|
update-check, learnings — script doesn't touch that infra. Disabled skills
|
|
are just hidden from Claude Code's scanner; the gstack repo stays installed.
|
|
- Profile changes DO toggle the managed Claude Code plugins (ui-ux-pro-max,
|
|
plugin-dev, pr-review-toolkit) and the managed external packs
|
|
(emil-design-eng, frontend-design, design-motion-principles, impeccable,
|
|
the 21st design skills) — in BOTH directions: `set` enables what the profile
|
|
lists and disables the managed leftovers it doesn't (BDR-008, BDR-079).
|
|
Anything outside those allowlists stays manual: `claude plugin
|
|
enable|disable`, `bash lib/toggle-external.sh enable|disable <tool>`.
|
|
- `set` is destructive in the sense that it disables non-listed gstack skills.
|
|
Use `apply` if the user wants additive behavior.
|