From 3da9d67ebbf7724b949bfe851f1018fe8b3fe8b7 Mon Sep 17 00:00:00 2001 From: bchanot Date: Mon, 2 Nov 2026 01:47:25 +0100 Subject: [PATCH] docs: README make profile dir=, stale 21st/higgsfield lines, MIGRATION heading --- MIGRATION.md | 4 ++-- README.md | 10 +++++----- rules/web-building.md | 3 ++- 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/MIGRATION.md b/MIGRATION.md index ce98e26..86be014 100644 --- a/MIGRATION.md +++ b/MIGRATION.md @@ -198,12 +198,12 @@ make doctor - **Default profile**: a project with no local profile runs the manifest defaults (= `full`). Check with `bash lib/profile.sh current`. Nine gstack skills (`ship`, `land-and-deploy`, `setup-deploy`, `autoplan`, `context-save`, `learn`, `careful`, `guard`, `design-shotgun`) left every profile and are denylisted. - **Higgsfield**: installed, off by default. Nothing to do until you enable it. -### 2.1.0 — profiles and packs +### 2.1.0: profiles and packs Run on every machine that pulls this version (the live tree may still be in an old profile; nothing below deletes a real directory). -1. `git pull`, then restore the user-scope plugins the old `profile.sh` had +1. From the repo root (`cd ~/.claude`): `git pull`, then restore the user-scope plugins the old `profile.sh` had toggled: `git show HEAD:settings.json | jq .enabledPlugins > /tmp/ep.json && jq --slurpfile ep /tmp/ep.json '.enabledPlugins = $ep[0]' settings.json > /tmp/settings.next.json && cp /tmp/settings.next.json settings.json` diff --git a/README.md b/README.md index fe3e567..f205ac9 100644 --- a/README.md +++ b/README.md @@ -185,7 +185,7 @@ ctx7 login # optional: OAuth / API key for higher rate limits | **Context7** | CLI (`ctx7`) | Doc lookup for fast-evolving libs (Next.js, React, Prisma...), used through the `find-docs` skill. Works anonymously; optional `ctx7 login` raises rate limits. | [context7.com](https://context7.com/) | | **pr-review-toolkit** | Plugin (toggle) | Multi-agent PR review. | [anthropics/claude-code](https://github.com/anthropics/claude-code) | | **Graphify** | Python CLI | Codebase → knowledge graph → navigable wiki. Helps Claude map and search projects efficiently. | [pypi: graphifyy](https://pypi.org/project/graphifyy/) | -| **21st.dev** | External CLI + skill pack | Component catalog and UI generation (`21st`), browser login, no API key. 7 skills in `skills-external/21st-*`, linked by pack-design and pack-extras (see the 21st.dev CLI section). | [npm: @21st-dev/cli](https://www.npmjs.com/package/@21st-dev/cli) | +| **21st.dev** | External CLI + skill pack | Component catalog and UI generation (`21st`), browser login, no API key. 8 skills in `skills-external/21st-*`, linked by pack-design and pack-extras (see the 21st.dev CLI section). | [npm: @21st-dev/cli](https://www.npmjs.com/package/@21st-dev/cli) | | **Higgsfield** | External CLI + skill pack (off by default) | Image, video, audio and brand media generation, metered credits (see the Higgsfield CLI section). | [higgsfield-ai/skills](https://github.com/higgsfield-ai/skills) | | **Semgrep** | Python CLI (pinned) | SAST engine behind the security gate (`security-auditor`). | [pypi: semgrep](https://pypi.org/project/semgrep/) | | **Impeccable** | npm CLI + skill (pinned) | Deterministic anti-slop detector (`npx impeccable detect`, 61 rules) and the `/impeccable` design verbs. | [npm: impeccable](https://www.npmjs.com/package/impeccable) | @@ -436,8 +436,8 @@ skills. `higgsfield-websites` is kept apart. It helps with landing pages inside the design stack (assets, references), and `higgsfield website -create|deploy|publish` stays unused. Claude enables either toggle itself on -an explicit ask (Skill routing in `CLAUDE.global.md`) and checks the price +create|deploy|publish` stays unused. Claude runs `bash lib/profile.sh enable higgsfield` on +a named media ask, then `/reload-plugins` (Skill routing in `CLAUDE.global.md`) and checks the price with `higgsfield generate cost` before a paid run. The skills are cloned, not installed with `npx skills add`: that installer @@ -477,9 +477,9 @@ make scan-secrets [repos="…"] # gitleaks sweep of this repo's history and ~/. make help # list make targets make onboard # onboard an existing project (run from its dir) make seo-connect # connect a Google account for /seo FULL (OAuth consent) -make profile cmd="set X" # activate a skill profile (web/seo/web-full/full/max/backend/design/dev/qa/audit/minimal) +make profile cmd="set X" dir=/path/to/project # activate a skill profile (web/seo/web-full/full/max/backend/design/dev/qa/audit/minimal) make profile-list # list skill profiles -make profile-current # effective profile of this project and conversation +make profile-current dir=/path/to/project # effective profile of this project and conversation make new-skill name=myskill # scaffold agent + skill files ``` diff --git a/rules/web-building.md b/rules/web-building.md index 7f83126..cab3783 100644 --- a/rules/web-building.md +++ b/rules/web-building.md @@ -65,4 +65,5 @@ Scope doubt → ask or default to Build, never silently skip. Gate: light skills run `~/.claude/lib/design-gate.md`, orchestrators plugin-check. 21st = CLI (`npm i -g @21st-dev/cli`, `21st login`), no MCP, no key; search free, `21st get`/`generate` metered → generation, not micro-tweaks. 21st-ai / -ui-explore / ui-review are `max`-profile only (pack-extras; `profile.sh enable extras`). +ui-explore / ui-review are `max`-profile only (pack-extras; +`profile.sh enable extras`).