docs: README make profile dir=, stale 21st/higgsfield lines, MIGRATION heading

This commit is contained in:
bchanot committed 2026-11-02 01:47:25 +01:00
1 parent 438cd57818
commit 3da9d67ebb
3 files changed
+9 -8

No files matched your search

+2 -2
View File
@@ -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. - **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. - **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 Run on every machine that pulls this version (the live tree may still be in
an old profile; nothing below deletes a real directory). 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 toggled: `git show HEAD:settings.json | jq .enabledPlugins > /tmp/ep.json
&& jq --slurpfile ep /tmp/ep.json '.enabledPlugins = $ep[0]' settings.json && jq --slurpfile ep /tmp/ep.json '.enabledPlugins = $ep[0]' settings.json
> /tmp/settings.next.json && cp /tmp/settings.next.json settings.json` > /tmp/settings.next.json && cp /tmp/settings.next.json settings.json`
+5 -5
View File
@@ -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/) | | **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) | | **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/) | | **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) | | **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/) | | **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) | | **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 `higgsfield-websites` is kept apart. It helps with landing pages inside the
design stack (assets, references), and `higgsfield website design stack (assets, references), and `higgsfield website
create|deploy|publish` stays unused. Claude enables either toggle itself on create|deploy|publish` stays unused. Claude runs `bash lib/profile.sh enable higgsfield` on
an explicit ask (Skill routing in `CLAUDE.global.md`) and checks the price 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. with `higgsfield generate cost` before a paid run.
The skills are cloned, not installed with `npx skills add`: that installer 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 help # list make targets
make onboard # onboard an existing project (run from its dir) make onboard # onboard an existing project (run from its dir)
make seo-connect # connect a Google account for /seo FULL (OAuth consent) 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-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 make new-skill name=myskill # scaffold agent + skill files
``` ```
+2 -1
View File
@@ -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 = 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, 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 / `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`).