Rename project-presence to polish-repo (#101)

elijahr · web-flow · commit e28f7e1e4c1a · 2026-03-06T04:39:32.000-06:00
* Rename project-presence skill to polish-repo

Rename skill, all 5 commands, docs, and cross-references for a shorter,
more memorable name.

* Fix missed rename references per Gemini review

Update headings in naming and identity commands, fix broken
/polish-repo command reference to /polish-repo-audit, and
update AGENTS.md suggestion heading.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -10,7 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.24.0] - 2026-03-06
 
 ### Added
-- **project-presence skill** - New skill for improving open source project discoverability and presentation without relying on social media. Includes 5 phase commands covering README authoring (scratch/improve/replace), naming workshops, visual identity briefs, community infrastructure, and a 100-point audit scoring rubric. Based on analysis of 50+ open source projects across Python, Go, JS, and Rust ecosystems.
+- **polish-repo skill** - New skill for improving open source project discoverability and presentation without relying on social media. Includes 5 phase commands covering README authoring (scratch/improve/replace), naming workshops, visual identity briefs, community infrastructure, and a 100-point audit scoring rubric. Based on analysis of 50+ open source projects across Python, Go, JS, and Rust ecosystems.
 - **Community infrastructure** - Issue templates (bug report + feature request) using GitHub YAML form format, lightweight PR template, CONTRIBUTING.md with dev setup and skill authoring guide, SECURITY.md with spellbook-specific vulnerability scope, and a welcome bot GitHub Action for first-time contributors.
 - **GitHub topics** - Added 15 topics for discoverability (ai-assistant, claude, mcp, python, etc.)
 - **Homepage URL** - Set to docs site for repo metadata completeness.
diff --git a/README.md b/README.md
@@ -209,7 +209,7 @@ Reusable workflows for structured development:
 | **Code Quality** | [enforcing-code-quality], [code-review], [advanced-code-review], [auditing-green-mirage], [fixing-tests], [fact-checking], [finding-dead-code], [distilling-prs], [receiving-code-review]†, [requesting-code-review]† |
 | **Feature Dev** | [implementing-features], [reviewing-design-docs], [reviewing-impl-plans], [reviewing-prs], [devils-advocate], [merging-worktrees], [resolving-merge-conflicts], [creating-issues-and-pull-requests] |
 | **Autonomous Dev** | [autonomous-roundtable], [gathering-requirements], [dehallucination], [reflexion], [analyzing-domains], [assembling-context], [designing-workflows], [deep-research], [fractal-thinking] |
-| **Specialized** | [async-await-patterns], [using-lsp-tools], [managing-artifacts], [project-presence], [security-auditing], [generating-diagrams] |
+| **Specialized** | [async-await-patterns], [using-lsp-tools], [managing-artifacts], [polish-repo], [security-auditing], [generating-diagrams] |
 | **Meta** | [using-skills]†, [writing-skills]†, [writing-commands], [instruction-engineering], [sharpening-prompts], [optimizing-instructions], [dispatching-parallel-agents]†, [smart-reading], [project-encyclopedia] *(deprecated)*, [analyzing-skill-usage], [documenting-tools] |
 | **Session** | [fun-mode], [tarot-mode], [emotional-stakes] |
 
@@ -252,7 +252,7 @@ Reusable workflows for structured development:
 [dispatching-parallel-agents]: https://axiomantic.github.io/spellbook/latest/skills/dispatching-parallel-agents/
 [smart-reading]: https://axiomantic.github.io/spellbook/latest/skills/smart-reading/
 [project-encyclopedia]: https://axiomantic.github.io/spellbook/latest/skills/project-encyclopedia/
-[project-presence]: https://axiomantic.github.io/spellbook/latest/skills/project-presence/
+[polish-repo]: https://axiomantic.github.io/spellbook/latest/skills/polish-repo/
 [analyzing-skill-usage]: https://axiomantic.github.io/spellbook/latest/skills/analyzing-skill-usage/
 [documenting-tools]: https://axiomantic.github.io/spellbook/latest/skills/documenting-tools/
 [writing-commands]: https://axiomantic.github.io/spellbook/latest/skills/writing-commands/
@@ -317,11 +317,11 @@ Reusable workflows for structured development:
 | [/mode] | Switch session mode (fun/tarot/off) |
 | [/pr-distill] | Analyze PR, categorize changes by review necessity |
 | [/pr-distill-bless] | Save discovered pattern for future distillations |
-| [/project-presence-audit] | Phases 0-1 of project-presence: Reconnaissance gathering and audit scorecard generation |
-| [/project-presence-community] | Phase 3 of project-presence: Community infrastructure, issue templates, roadmap, contributor experience, and signs of life |
-| [/project-presence-identity] | Phase 3 of project-presence: Visual identity, badges, GitHub metadata, topics, and documentation strategy |
-| [/project-presence-naming] | Phase 3 of project-presence: Naming workshop, tagline crafting, and positioning strategy |
-| [/project-presence-readme] | Phase 3 of project-presence: README authoring from scratch, improvement, or replacement |
+| [/polish-repo-audit] | Phases 0-1 of polish-repo: Reconnaissance gathering and audit scorecard generation |
+| [/polish-repo-community] | Phase 3 of polish-repo: Community infrastructure, issue templates, roadmap, contributor experience, and signs of life |
+| [/polish-repo-identity] | Phase 3 of polish-repo: Visual identity, badges, GitHub metadata, topics, and documentation strategy |
+| [/polish-repo-naming] | Phase 3 of polish-repo: Naming workshop, tagline crafting, and positioning strategy |
+| [/polish-repo-readme] | Phase 3 of polish-repo: README authoring from scratch, improvement, or replacement |
 | [/advanced-code-review-plan] | Phase 1: Strategic planning for code review |
 | [/advanced-code-review-context] | Phase 2: Context analysis and previous review loading |
 | [/advanced-code-review-review] | Phase 3: Deep multi-pass code review |
@@ -411,11 +411,11 @@ Reusable workflows for structured development:
 [/mode]: https://axiomantic.github.io/spellbook/latest/commands/mode/
 [/pr-distill]: https://axiomantic.github.io/spellbook/latest/commands/pr-distill/
 [/pr-distill-bless]: https://axiomantic.github.io/spellbook/latest/commands/pr-distill-bless/
-[/project-presence-audit]: https://axiomantic.github.io/spellbook/latest/commands/project-presence-audit/
-[/project-presence-community]: https://axiomantic.github.io/spellbook/latest/commands/project-presence-community/
-[/project-presence-identity]: https://axiomantic.github.io/spellbook/latest/commands/project-presence-identity/
-[/project-presence-naming]: https://axiomantic.github.io/spellbook/latest/commands/project-presence-naming/
-[/project-presence-readme]: https://axiomantic.github.io/spellbook/latest/commands/project-presence-readme/
+[/polish-repo-audit]: https://axiomantic.github.io/spellbook/latest/commands/polish-repo-audit/
+[/polish-repo-community]: https://axiomantic.github.io/spellbook/latest/commands/polish-repo-community/
+[/polish-repo-identity]: https://axiomantic.github.io/spellbook/latest/commands/polish-repo-identity/
+[/polish-repo-naming]: https://axiomantic.github.io/spellbook/latest/commands/polish-repo-naming/
+[/polish-repo-readme]: https://axiomantic.github.io/spellbook/latest/commands/polish-repo-readme/
 [/advanced-code-review-plan]: https://axiomantic.github.io/spellbook/latest/commands/advanced-code-review-plan/
 [/advanced-code-review-context]: https://axiomantic.github.io/spellbook/latest/commands/advanced-code-review-context/
 [/advanced-code-review-review]: https://axiomantic.github.io/spellbook/latest/commands/advanced-code-review-review/
diff --git a/commands/polish-repo-audit.md b/commands/polish-repo-audit.md
@@ -1,5 +1,5 @@
 ---
-description: "Phases 0-1 of project-presence: Reconnaissance gathering and audit scorecard generation"
+description: "Phases 0-1 of polish-repo: Reconnaissance gathering and audit scorecard generation"
 ---
 
 ## ROLE
diff --git a/commands/polish-repo-community.md b/commands/polish-repo-community.md
@@ -1,5 +1,5 @@
 ---
-description: "Phase 3 of project-presence: Community infrastructure, issue templates, roadmap, contributor experience, and signs of life"
+description: "Phase 3 of polish-repo: Community infrastructure, issue templates, roadmap, contributor experience, and signs of life"
 ---
 
 # Community Infrastructure
@@ -503,7 +503,7 @@ Produce this checklist as a standalone document the user can reference. An activ
 
 ### Quarterly
 
-- [ ] Re-run the project-presence audit to check for drift
+- [ ] Re-run the polish-repo audit to check for drift
 - [ ] Review GitHub topics for continued relevance
 - [ ] Check if new awesome lists or directories have appeared in your domain
 - [ ] Review contributor experience: try the dev setup from scratch on a clean machine
diff --git a/commands/polish-repo-identity.md b/commands/polish-repo-identity.md
@@ -1,8 +1,8 @@
 ---
-description: "Phase 3 of project-presence: Visual identity, badges, GitHub metadata, topics, and documentation strategy"
+description: "Phase 3 of polish-repo: Visual identity, badges, GitHub metadata, topics, and documentation strategy"
 ---
 
-# Project Presence - Identity
+# Polish Repo - Identity
 
 ## ROLE
 
diff --git a/commands/polish-repo-naming.md b/commands/polish-repo-naming.md
@@ -1,8 +1,8 @@
 ---
-description: "Phase 3 of project-presence: Naming workshop, tagline crafting, and positioning strategy"
+description: "Phase 3 of polish-repo: Naming workshop, tagline crafting, and positioning strategy"
 ---
 
-# Project Presence - Naming and Positioning
+# Polish Repo - Naming and Positioning
 
 ## ROLE
 
diff --git a/commands/polish-repo-readme.md b/commands/polish-repo-readme.md
@@ -1,5 +1,5 @@
 ---
-description: "Phase 3 of project-presence: README authoring from scratch, improvement, or replacement"
+description: "Phase 3 of polish-repo: README authoring from scratch, improvement, or replacement"
 ---
 
 # README Authoring Command
diff --git a/docs/commands/index.md b/docs/commands/index.md
@@ -63,13 +63,13 @@ Commands are slash commands that can be invoked with `/<command-name>` in Claude
 | [/merge-worktree-verify](merge-worktree-verify.md) | Phases 4-5: Final Verification and Cleanup — run full test suite, verify contrac... | spellbook |
 | [/mode](mode.md) | Switch session mode between fun, tarot, or off | spellbook |
 | [/move-project](move-project.md) | Move project: relocate directory and update Claude Code session references safel... | spellbook |
+| [/polish-repo-audit](polish-repo-audit.md) | Phases 0-1 of polish-repo: Reconnaissance gathering and audit scorecard generati... | spellbook |
+| [/polish-repo-community](polish-repo-community.md) | Phase 3 of polish-repo: Community infrastructure, issue templates, roadmap, cont... | spellbook |
+| [/polish-repo-identity](polish-repo-identity.md) | Phase 3 of polish-repo: Visual identity, badges, GitHub metadata, topics, and do... | spellbook |
+| [/polish-repo-naming](polish-repo-naming.md) | Phase 3 of polish-repo: Naming workshop, tagline crafting, and positioning strat... | spellbook |
+| [/polish-repo-readme](polish-repo-readme.md) | Phase 3 of polish-repo: README authoring from scratch, improvement, or replaceme... | spellbook |
 | [/pr-distill](pr-distill.md) | Analyze a PR and generate a review distillation report that categorizes changes ... | spellbook |
 | [/pr-distill-bless](pr-distill-bless.md) | Save a discovered pattern for future PR distillation, adding it to the blessed p... | spellbook |
-| [/project-presence-audit](project-presence-audit.md) | Phases 0-1 of project-presence: Reconnaissance gathering and audit scorecard gen... | spellbook |
-| [/project-presence-community](project-presence-community.md) | Phase 3 of project-presence: Community infrastructure, issue templates, roadmap,... | spellbook |
-| [/project-presence-identity](project-presence-identity.md) | Phase 3 of project-presence: Visual identity, badges, GitHub metadata, topics, a... | spellbook |
-| [/project-presence-naming](project-presence-naming.md) | Phase 3 of project-presence: Naming workshop, tagline crafting, and positioning ... | spellbook |
-| [/project-presence-readme](project-presence-readme.md) | Phase 3 of project-presence: README authoring from scratch, improvement, or repl... | spellbook |
 | [/reflexion-analyze](reflexion-analyze.md) | Steps 1-3 of reflexion: Parse feedback, categorize root causes, store reflection... | spellbook |
 | [/request-review-artifacts](request-review-artifacts.md) | Request Code Review artifact contract: directory structure, phase outputs, manif... | spellbook |
 | [/request-review-execute](request-review-execute.md) | Request Code Review Phases 3-6: Dispatch review agent, triage findings, execute ... | spellbook |
diff --git a/docs/commands/polish-repo-audit.md b/docs/commands/polish-repo-audit.md
@@ -1,4 +1,4 @@
-# /project-presence-audit
+# /polish-repo-audit
 ## Command Content
 
 ``````````markdown
diff --git a/docs/commands/polish-repo-community.md b/docs/commands/polish-repo-community.md
@@ -1,4 +1,4 @@
-# /project-presence-community
+# /polish-repo-community
 ## Command Content
 
 ``````````markdown
@@ -503,7 +503,7 @@ Produce this checklist as a standalone document the user can reference. An activ
 
 ### Quarterly
 
-- [ ] Re-run the project-presence audit to check for drift
+- [ ] Re-run the polish-repo audit to check for drift
 - [ ] Review GitHub topics for continued relevance
 - [ ] Check if new awesome lists or directories have appeared in your domain
 - [ ] Review contributor experience: try the dev setup from scratch on a clean machine
diff --git a/docs/commands/polish-repo-identity.md b/docs/commands/polish-repo-identity.md
@@ -1,8 +1,8 @@
-# /project-presence-identity
+# /polish-repo-identity
 ## Command Content
 
 ``````````markdown
-# Project Presence - Identity
+# Polish Repo - Identity
 
 ## ROLE
 
diff --git a/docs/commands/polish-repo-naming.md b/docs/commands/polish-repo-naming.md
@@ -1,8 +1,8 @@
-# /project-presence-naming
+# /polish-repo-naming
 ## Command Content
 
 ``````````markdown
-# Project Presence - Naming and Positioning
+# Polish Repo - Naming and Positioning
 
 ## ROLE
 
diff --git a/docs/commands/polish-repo-readme.md b/docs/commands/polish-repo-readme.md
@@ -1,4 +1,4 @@
-# /project-presence-readme
+# /polish-repo-readme
 ## Command Content
 
 ``````````markdown
diff --git a/docs/skills/polish-repo.md b/docs/skills/polish-repo.md
@@ -1,4 +1,4 @@
-# project-presence
+# polish-repo
 
 Use when improving project discoverability, attracting users/contributors, or presenting open source work. Triggers: 'write a README', 'improve README', 'get more users', 'get more contributors', 'add badges', 'create a logo', 'set up issue templates', 'audit this project', 'project presence', 'make this discoverable', 'why isn't anyone using this', 'prepare for launch', 'repo presentation', 'open source marketing', 'attract contributors', 'project storefront'. Also triggers on: naming a project, writing taglines, GitHub metadata, community infrastructure, signs of life.
 ## Skill Content
@@ -93,7 +93,7 @@ Store all findings in a structured report for Phase 1.
 
 ## Phase 1: Audit and Scorecard
 
-Run the scoring rubric defined in `/project-presence-audit` (Phase 1: Audit and Scorecard). That command contains the single source of truth for the 100-point scoring criteria, letter grade thresholds, and anti-pattern detection list. Present results as a scorecard with letter grade and flag any anti-patterns detected.
+Run the scoring rubric defined in `/polish-repo-audit` (Phase 1: Audit and Scorecard). That command contains the single source of truth for the 100-point scoring criteria, letter grade thresholds, and anti-pattern detection list. Present results as a scorecard with letter grade and flag any anti-patterns detected.
 
 ## Phase 2: Interview
 
@@ -134,10 +134,10 @@ Dispatch to the appropriate command(s) based on user's choices:
 
 | Domain | Command | What It Produces |
 |--------|---------|-----------------|
-| Naming + positioning | `/project-presence-naming` | Name candidates, tagline, GitHub description |
-| README authoring | `/project-presence-readme` | Complete README.md (scratch / improve / replace) |
-| Visual identity + metadata | `/project-presence-identity` | Logo brief, badges, topics, metadata |
-| Community infrastructure | `/project-presence-community` | Issue templates, PR template, CONTRIBUTING.md, roadmap issues |
+| Naming + positioning | `/polish-repo-naming` | Name candidates, tagline, GitHub description |
+| README authoring | `/polish-repo-readme` | Complete README.md (scratch / improve / replace) |
+| Visual identity + metadata | `/polish-repo-identity` | Logo brief, badges, topics, metadata |
+| Community infrastructure | `/polish-repo-community` | Issue templates, PR template, CONTRIBUTING.md, roadmap issues |
 | Full audit execution | All of the above in sequence | Complete project presence overhaul |
 
 **Dispatch template:**
@@ -202,9 +202,9 @@ The community command creates issues in three tiers (actionable, contributor mag
 
 Suggest adding a maintenance reminder to the project's AGENTS.md:
 ```
-## README and Project Presence
+## README and Repo Presentation
 When making significant changes, verify the README still accurately reflects the project.
-Run `/project-presence` audit periodically to check for presentation drift.
+Run `/polish-repo-audit` periodically to check for presentation drift.
 ```
 
 ## FORBIDDEN
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -111,7 +111,7 @@ nav:
       - skills/async-await-patterns.md
       - skills/using-lsp-tools.md
       - skills/managing-artifacts.md
-      - skills/project-presence.md
+      - skills/polish-repo.md
       - skills/security-auditing.md
       - skills/generating-diagrams.md
     - Meta Skills:
@@ -207,11 +207,11 @@ nav:
       - commands/merge-worktree-resolve.md
       - commands/merge-worktree-verify.md
     - Project Presence Commands:
-      - commands/project-presence-audit.md
-      - commands/project-presence-community.md
-      - commands/project-presence-identity.md
-      - commands/project-presence-naming.md
-      - commands/project-presence-readme.md
+      - commands/polish-repo-audit.md
+      - commands/polish-repo-community.md
+      - commands/polish-repo-identity.md
+      - commands/polish-repo-naming.md
+      - commands/polish-repo-readme.md
     - Reflexion Commands:
       - commands/reflexion-analyze.md
     - Request Review Commands:
diff --git a/skills/polish-repo/SKILL.md b/skills/polish-repo/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: project-presence
+name: polish-repo
 description: "Use when improving project discoverability, attracting users/contributors, or presenting open source work. Triggers: 'write a README', 'improve README', 'get more users', 'get more contributors', 'add badges', 'create a logo', 'set up issue templates', 'audit this project', 'project presence', 'make this discoverable', 'why isn't anyone using this', 'prepare for launch', 'repo presentation', 'open source marketing', 'attract contributors', 'project storefront'. Also triggers on: naming a project, writing taglines, GitHub metadata, community infrastructure, signs of life."
 ---
 
@@ -92,7 +92,7 @@ Store all findings in a structured report for Phase 1.
 
 ## Phase 1: Audit and Scorecard
 
-Run the scoring rubric defined in `/project-presence-audit` (Phase 1: Audit and Scorecard). That command contains the single source of truth for the 100-point scoring criteria, letter grade thresholds, and anti-pattern detection list. Present results as a scorecard with letter grade and flag any anti-patterns detected.
+Run the scoring rubric defined in `/polish-repo-audit` (Phase 1: Audit and Scorecard). That command contains the single source of truth for the 100-point scoring criteria, letter grade thresholds, and anti-pattern detection list. Present results as a scorecard with letter grade and flag any anti-patterns detected.
 
 ## Phase 2: Interview
 
@@ -133,10 +133,10 @@ Dispatch to the appropriate command(s) based on user's choices:
 
 | Domain | Command | What It Produces |
 |--------|---------|-----------------|
-| Naming + positioning | `/project-presence-naming` | Name candidates, tagline, GitHub description |
-| README authoring | `/project-presence-readme` | Complete README.md (scratch / improve / replace) |
-| Visual identity + metadata | `/project-presence-identity` | Logo brief, badges, topics, metadata |
-| Community infrastructure | `/project-presence-community` | Issue templates, PR template, CONTRIBUTING.md, roadmap issues |
+| Naming + positioning | `/polish-repo-naming` | Name candidates, tagline, GitHub description |
+| README authoring | `/polish-repo-readme` | Complete README.md (scratch / improve / replace) |
+| Visual identity + metadata | `/polish-repo-identity` | Logo brief, badges, topics, metadata |
+| Community infrastructure | `/polish-repo-community` | Issue templates, PR template, CONTRIBUTING.md, roadmap issues |
 | Full audit execution | All of the above in sequence | Complete project presence overhaul |
 
 **Dispatch template:**
@@ -201,9 +201,9 @@ The community command creates issues in three tiers (actionable, contributor mag
 
 Suggest adding a maintenance reminder to the project's AGENTS.md:
 ```
-## README and Project Presence
+## README and Repo Presentation
 When making significant changes, verify the README still accurately reflects the project.
-Run `/project-presence` audit periodically to check for presentation drift.
+Run `/polish-repo-audit` periodically to check for presentation drift.
 ```
 
 ## FORBIDDEN

-Original file line number
+Diff line change
@@ @@ -1,5 +1,5 @@ @@
 ---
 -description: "Phases 0-1 of project-presence: Reconnaissance gathering and audit scorecard generation"
 +description: "Phases 0-1 of polish-repo: Reconnaissance gathering and audit scorecard generation"
 ---
 ## ROLE
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# /project-presence-audit`
	`1`	`+# /polish-repo-audit`
`2`	`2`	`## Command Content`
`3`	`3`
`4`	`4`	``````````markdown