Skip to content

Commit 835fc74

Browse files
camawjonesclaude
andauthored
Fix install symlinks (#5)
* Add ./create installer to symlink skills into ~/.claude/skills A plain `git clone` into ~/.claude/skills/creativestack produces a nested structure that Claude Code does not discover, since skills must live at ~/.claude/skills/<name>/SKILL.md rather than one level deeper. Add a `create` script that symlinks each skills/<name>/SKILL.md into ~/.claude/skills/<name>/SKILL.md and each agents/<name>.md into ~/.claude/agents/<name>.md, so all 29 skills and 4 workflow agents appear flat. Same pattern gstack uses. Symlinking SKILL.md (not the whole directory) keeps bundled references/ resolving correctly because paths resolve relative to the symlink target's real location. The installer is idempotent (safe to re-run after `git pull`) and `--uninstall` only removes symlinks that point back into the repo. Update README install, update, and uninstall sections accordingly. Named `create` rather than `setup` to avoid confusion with `/setup-cs`. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Ignore local .claude/ settings directory Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Ignore .cursor/ and .env files Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Rename /setup-cs to /setup-brain The previous name was picked to avoid colliding with the generic /setup command used by other skill stacks, but it was terse and unmemorable. /setup-brain ties directly to the product's central metaphor — every other skill reads from and writes to "the Brain" (the Context Vault at ~/.creativestack/), so naming the onboarding skill after the thing it creates is self-documenting. Also avoids confusion with the repo's new ./create installer, where the prior pairing of ./setup (script) and /setup-cs (skill) would have been needlessly similar if the installer had been called setup. - Rename _build/templates/setup-cs → setup-brain - Rename skills/setup-cs → setup-brain (regenerated from template) - Replace all /setup-cs references across templates, shared content, README, CLAUDE.md, CHANGELOG, scripts/check-brain.sh, and create - Rebuild all skills to propagate the rename Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 1e590f7 commit 835fc74

56 files changed

Lines changed: 284 additions & 278 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,12 @@ Thumbs.db
1111
# IDE
1212
.vscode/
1313
.idea/
14+
.cursor/
1415

1516
# Local Claude Code settings
1617
.claude/
18+
19+
# Environment variables
20+
.env
21+
.env.local
22+
.env.*.local

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
77
## [Unreleased]
88

99
### Changed
10-
- Converted from Claude Code plugin to flat skill stack. Skills now invoked as `/skill-name` instead of `/creativestack:skill-name`. The `setup` skill was renamed to `setup-cs` to avoid collision with other stacks.
10+
- Converted from Claude Code plugin to flat skill stack. Skills now invoked as `/skill-name` instead of `/creativestack:skill-name`. The `setup` skill was renamed to `setup-brain` to avoid collision with other stacks.
1111
- Removed `.claude-plugin/` manifest and `hooks/` directory (plugin-only).
1212
- `scripts/check-brain.sh` self-locates instead of relying on `$CLAUDE_PLUGIN_ROOT`; install manually as a SessionStart hook via `~/.claude/settings.json` if desired.
1313

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ AI skill suite for creative professionals. 29 skills across 10 categories, plus
44

55
## Project structure
66

7-
This is a flat Claude Code skill stack installed at `~/.claude/skills/creativestack`. Skills are invoked flat as `/skill-name` (the parent directory is just a grouping — it does not create a namespace). The `setup` skill is named `setup-cs` to avoid collision with other stacks.
7+
This is a flat Claude Code skill stack installed at `~/.claude/skills/creativestack`. Skills are invoked flat as `/skill-name` (the parent directory is just a grouping — it does not create a namespace). The `setup` skill is named `setup-brain` to avoid collision with other stacks.
88

99
- Skills live in `skills/*/SKILL.md` (generated — do not edit directly)
1010
- Source templates live in `_build/templates/*/SKILL.md.tmpl`

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ cd ~/.claude/skills/creativestack
4242

4343
`./create` symlinks each skill's `SKILL.md` into `~/.claude/skills/<name>/SKILL.md` and each workflow agent into `~/.claude/agents/<name>.md`, so Claude Code discovers them as flat top-level entries. Restart Claude Code and all 29 skills and 4 agents are available — invoked flat as `/creative-brief`, `/meeting-notes`, `/competitor-audit`, and so on.
4444

45-
The one skill with a non-obvious name is `/setup-cs` (renamed from `/setup` to avoid colliding with other skill stacks). Everything else matches its directory name.
45+
The one skill with a non-obvious name is `/setup-brain` (renamed from `/setup` to avoid colliding with other skill stacks). Everything else matches its directory name.
4646

4747
### Updates
4848

@@ -83,10 +83,10 @@ Skip this and everything still works — each skill does its own brain-freshness
8383
**1. Set up your brain (5 minutes - optional but transformative)**
8484

8585
```
86-
/setup-cs
86+
/setup-brain
8787
```
8888

89-
This is an onboarding flow, not an installer — the skills are already installed by the `git clone`. `/setup-cs` walks you through who you are, your team, your tone of voice, and your standard methodology, and creates your Context Vault at `~/.creativestack/`. Every other skill reads from this vault and gets sharper because of it.
89+
This is an onboarding flow, not an installer — the skills are already installed by the `git clone`. `/setup-brain` walks you through who you are, your team, your tone of voice, and your standard methodology, and creates your Context Vault at `~/.creativestack/`. Every other skill reads from this vault and gets sharper because of it.
9090

9191
You can skip this entirely and use any skill immediately — they'll work, just generically.
9292

@@ -123,7 +123,7 @@ Every CreativeStack skill reads from and (with permission) writes to `~/.creativ
123123

124124
### Foundation files
125125

126-
Created by `/setup-cs` - the baseline:
126+
Created by `/setup-brain` - the baseline:
127127

128128
| File | What it holds |
129129
|---|---|
@@ -225,7 +225,7 @@ These all live in the brain precisely so you don't have to touch the skill templ
225225

226226
| Skill | What it does |
227227
|---|---|
228-
| `/setup-cs` | Initialise or refresh your brain - profile, tone of voice, team, clients, methodology |
228+
| `/setup-brain` | Initialise or refresh your brain - profile, tone of voice, team, clients, methodology |
229229
| `/update-voice` | Refine your tone-of-voice guidelines with examples and do/don't rules |
230230

231231
### Daily operations

_build/build-skills.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ for tmpl in "$SCRIPT_DIR"/templates/*/SKILL.md.tmpl; do
3333
# Replace {{PROJECT_STATE}} placeholder (only present in project-aware skills)
3434
content="${content//\{\{PROJECT_STATE\}\}/$PROJECT_STATE}"
3535

36-
# Replace {{VISUAL_STYLE_DEFAULT}} placeholder (used by setup-cs skill to seed brain)
36+
# Replace {{VISUAL_STYLE_DEFAULT}} placeholder (used by setup-brain skill to seed brain)
3737
content="${content//\{\{VISUAL_STYLE_DEFAULT\}\}/$VISUAL_STYLE_DEFAULT}"
3838

3939
# Write generated SKILL.md to skills/ directory

_build/shared/preamble.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ if [ -n "$BRAIN_DIR" ]; then
1111
echo "BRAIN: $BRAIN_DIR"
1212
ls "$BRAIN_DIR"/*.md 2>/dev/null | while read f; do echo " $(basename "$f")"; done
1313
else
14-
echo "BRAIN: not configured (run /setup-cs to set up)"
14+
echo "BRAIN: not configured (run /setup-brain to set up)"
1515
fi
1616
```
1717

@@ -20,7 +20,7 @@ Use the content to inform and contextualize all outputs. If the brain doesn't ex
2020
proceed generically — the skill still works, just without your specific context.
2121

2222
When the brain is not configured, mention once at the end of output:
23-
"Tip: Run /setup-cs to add your context — skills produce better results with it."
23+
"Tip: Run /setup-brain to add your context — skills produce better results with it."
2424

2525
### Brain Freshness Check
2626

@@ -41,14 +41,14 @@ to refresh — lightly, not annoyingly.
4141
|---|---|---|
4242
| `learnings.md` | 60 days | continuous skill use — skills append as they run |
4343
| `case-studies.md` | 90 days | `/case-study` |
44-
| `clients.md` | 90 days | `/setup-cs` |
44+
| `clients.md` | 90 days | `/setup-brain` |
4545
| `team.md` | 90 days | `/resource-conflict` Setup team mode |
4646
| `freelance-bench.md` | 120 days | `/resource-conflict` Setup bench mode |
4747
| `rate-card.md` | 180 days | `/project-profitability` Setup rates mode |
48-
| `methodology.md` | 180 days | `/setup-cs` |
48+
| `methodology.md` | 180 days | `/setup-brain` |
4949
| `tone-of-voice.md` | 180 days | `/update-voice` |
5050
| `sow-style.md` | 180 days | `/sow-generator` Edit style mode |
51-
| `profile.md` | 365 days | `/setup-cs` |
51+
| `profile.md` | 365 days | `/setup-brain` |
5252
| `projects/*` | N/A | living documents — updated by their own skills |
5353
| `prospects/*` | 90 days | `/pitch-research` Refresh mode |
5454

@@ -70,7 +70,7 @@ Keep it to 2-3 lines maximum. If more than 3 files are stale, summarise:
7070
```
7171
---
7272
📅 **Brain freshness:** {N} brain files are stale ({list names briefly}). Consider a
73-
session of `/setup-cs` Refresh mode to bring everything current.
73+
session of `/setup-brain` Refresh mode to bring everything current.
7474
```
7575

7676
5. **Severity gating:** only surface the check if at least one file is
@@ -85,7 +85,7 @@ session of `/setup-cs` Refresh mode to bring everything current.
8585
because brain data is stale. Surface, then proceed.
8686

8787
8. **No brain, no check:** if the brain isn't configured at all, skip the
88-
freshness check entirely. The `/setup-cs` nudge from the Brain
88+
freshness check entirely. The `/setup-brain` nudge from the Brain
8989
Discovery step is enough.
9090

9191
This check is lightweight by design. The goal is a gentle reminder, not an

_build/shared/visual-style-default.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,4 +180,4 @@ still looks good in three months. A rainbow deliverable looks dated by Friday.
180180
---
181181

182182
*This file is read by CreativeStack skills that produce visual output. Edit it to match
183-
your house style. Run `/setup-cs` to regenerate it from a preset.*
183+
your house style. Run `/setup-brain` to regenerate it from a preset.*

_build/templates/ai-audit/SKILL.md.tmpl

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: ai-audit
3-
description: AI readiness audit for creative professionals — four modes. Snapshot (the default — 10-minute self-assessment producing maturity scores across 5 sharpened categories, top 3 opportunities, 3-5 curated quick wins mapped to real CreativeStack skills, protected zone scoring, ROI framing in saved hours/revenue, Slack summary, discipline-aware questions, AI-advanced user branching). Leadership Pack (restructures the same data for a CEO/board audience with benchmark comparison, executive one-pager, and risk/opportunity framing so the user can take it to leadership to justify budget or hiring). Team Workshop (longer intake from multiple team member perspectives, surfaces disagreements as a distinct output, produces a workshop-ready slide outline plus the bringing-your-team-along change management plan with team anxieties, verbatim framings, protected-zone statement, 30-60-90 day plan, and handling-the-skeptic guidance). Deep Audit (includes prior-audit delta tracking, workflow walkthrough, tool stack review against tools.md). Uses practitioner-view industry benchmarks segmented by discipline and team size so users can answer "3/5 — is that good?". Writes audits to the brain as dated artefacts so repeat runs show measurable progress. Opt-in writes to learnings.md § AI maturity and tools.md. Every opportunity is mapped to a specific CreativeStack skill from a curated library, never invented. Use when a creative reaches for "where does AI fit in my practice", "I need to present AI strategy to my CEO", "I'm losing pitches to AI-native competitors", "which CreativeStack skills matter most for me", or "our team is nervous about AI and I need to lead on this". Also use as the natural second skill after /setup-cs.
3+
description: AI readiness audit for creative professionals — four modes. Snapshot (the default — 10-minute self-assessment producing maturity scores across 5 sharpened categories, top 3 opportunities, 3-5 curated quick wins mapped to real CreativeStack skills, protected zone scoring, ROI framing in saved hours/revenue, Slack summary, discipline-aware questions, AI-advanced user branching). Leadership Pack (restructures the same data for a CEO/board audience with benchmark comparison, executive one-pager, and risk/opportunity framing so the user can take it to leadership to justify budget or hiring). Team Workshop (longer intake from multiple team member perspectives, surfaces disagreements as a distinct output, produces a workshop-ready slide outline plus the bringing-your-team-along change management plan with team anxieties, verbatim framings, protected-zone statement, 30-60-90 day plan, and handling-the-skeptic guidance). Deep Audit (includes prior-audit delta tracking, workflow walkthrough, tool stack review against tools.md). Uses practitioner-view industry benchmarks segmented by discipline and team size so users can answer "3/5 — is that good?". Writes audits to the brain as dated artefacts so repeat runs show measurable progress. Opt-in writes to learnings.md § AI maturity and tools.md. Every opportunity is mapped to a specific CreativeStack skill from a curated library, never invented. Use when a creative reaches for "where does AI fit in my practice", "I need to present AI strategy to my CEO", "I'm losing pitches to AI-native competitors", "which CreativeStack skills matter most for me", or "our team is nervous about AI and I need to lead on this". Also use as the natural second skill after /setup-brain.
44
---
55

66
{{PREAMBLE}}
@@ -139,7 +139,7 @@ point. But if any of these ran earlier, pull in:
139139

140140
| Skill run earlier | What to use |
141141
|---|---|
142-
| `/setup-cs` | Skip the type/discipline/size questions |
142+
| `/setup-brain` | Skip the type/discipline/size questions |
143143
| `/project-profitability` | Skip commercials intake; use the data |
144144
| `/timesheet-summary` | Skip bottleneck question; use the findings |
145145
| `/resource-conflict` | Skip team capacity questions |
@@ -166,7 +166,7 @@ Report brain depth:
166166
Or thin:
167167

168168
> "Brain depth: Minimal — no brain configured. I'll run the audit
169-
> with neutral language and recommend `/setup-cs` at
169+
> with neutral language and recommend `/setup-brain` at
170170
> the end so the next audit compounds."
171171

172172
### Step 4: Intake
@@ -376,7 +376,7 @@ Offer **at most one** brain enrichment or next step. Pick the most
376376
valuable:
377377

378378
- **No brain configured** → "The biggest lift you can give this
379-
skill is configuring `/setup-cs` first. Takes 5
379+
skill is configuring `/setup-brain` first. Takes 5
380380
minutes and every future audit will be dramatically sharper."
381381
- **Prior audit exists and delta is positive** → "You moved from
382382
{X} to {Y} overall — measurable progress. This is exactly the
@@ -701,7 +701,7 @@ time.
701701

702702
- **No brain at all** → use neutral language ("your work", "your
703703
clients"), skip type-specific adaptations, end with a strong
704-
nudge to `/setup-cs` for next time.
704+
nudge to `/setup-brain` for next time.
705705
- **Brain exists but very thin** (profile only) → run the audit
706706
but note reduced depth in the output header.
707707
- **User is AI-advanced** → branch per Step 5. Never patronise.
@@ -733,15 +733,15 @@ time.
733733

734734
### Upstream (what feeds ai-audit)
735735

736-
- **No brain** → "`/setup-cs` first — takes 5 minutes and every future audit will be sharper."
736+
- **No brain** → "`/setup-brain` first — takes 5 minutes and every future audit will be sharper."
737737
- **No tone of voice** → "Consider `/update-voice` before the next audit so the output matches your voice."
738738
- **Running as a follow-up to setup** → natural flow, no nudge needed.
739739

740740
### Downstream (what ai-audit triggers)
741741

742742
Based on the audit's findings, suggest 1-2 of:
743743

744-
- **Lowest category = Knowledge & IP** → "Start with `/case-study` and `/setup-cs` — institutional memory is the single highest-leverage move."
744+
- **Lowest category = Knowledge & IP** → "Start with `/case-study` and `/setup-brain` — institutional memory is the single highest-leverage move."
745745
- **Lowest category = Ops & Admin** → "Run `/sow-generator` or `/timesheet-summary` this week — fastest wins, lowest risk."
746746
- **Lowest category = Creative Workflow** → "Run `/brief-sharpener` on your next incoming brief to feel the difference immediately."
747747
- **Lowest category = Client Comms** → "Run `/status-update` this week — 5-minute drafts your clients will notice."

_build/templates/ai-audit/references/quick-wins.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ Each win has this schema:
260260
- **What it looks like:** Configure your CreativeStack Brain — profile, team, tone of voice, clients, and tools — so every skill produces personalised output
261261
- **Time to value:** First value this week
262262
- **Effort:** L
263-
- **Skill:** `/setup-cs`
263+
- **Skill:** `/setup-brain`
264264
- **User types:** all
265265
- **Disciplines:** all
266266
- **Tier:** beginner-only

_build/templates/ai-audit/references/rubric.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ fed back into briefs, pitches, and proposals automatically.
115115
curate)
116116
- Personal craft rituals
117117

118-
**Maps to skills:** `/case-study`, `/post-mortem`, `/update-voice`, `/setup-cs`, `/brand-guidelines`
118+
**Maps to skills:** `/case-study`, `/post-mortem`, `/update-voice`, `/setup-brain`, `/brand-guidelines`
119119

120120
---
121121

@@ -325,7 +325,7 @@ answers or the brain has no context), the scoring is directional
325325
only. Flag with:
326326

327327
> **Confidence:** Low — based on brief answers without brain
328-
> context. Treat scores as directional. Running `/setup-cs`
328+
> context. Treat scores as directional. Running `/setup-brain`
329329
> first would sharpen the next audit significantly.
330330
331331
Never score confidently off thin evidence.

0 commit comments

Comments
 (0)