Skip to content

Save style skill globally for Claude Code - #86

Merged
shreyashankar merged 4 commits into
mainfrom
claude/global-style-skill-export
Aug 24, 2026
Merged

Save style skill globally for Claude Code#86
shreyashankar merged 4 commits into
mainfrom
claude/global-style-skill-export

Conversation

@shreyashankar

@shreyashankar shreyashankar commented Aug 24, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • When finalizing a style profile, a prompt asks whether to also save it to ~/.claude/skills/my-writing-style/ so Claude Code auto-loads it in every project
  • Copies the complete generated skill (SKILL.md + references/) — same format the docwriter-style-generator plugin produces
  • Adds GET /api/style-profile/user-skill to check for an existing global skill (only on explicit user action, no silent home-dir scanning)
  • Adds instant "Starting…" feedback when clicking "Run analysis" (the button was unresponsive while the POST was in flight)
  • Stops writing style-profile.json mirror — SQLite is the sole store now (read-fallback kept for migrating old installs)
  • Marks .agents/ and .claude/ as internal in the file tree (greyed out like .docwriter/)
  • Gitignores all .claude/skills/*/ since they are generated at runtime by syncSkillInstallations

Test plan

  • Run style analysis, finalize, click "Save globally" — verify ~/.claude/skills/my-writing-style/ contains SKILL.md + references/
  • Click "Just this project" — verify nothing written to ~/.claude/skills/
  • New Claude Code session in another project — verify my-writing-style skill loads
  • Click "Run analysis" — verify "Starting…" appears immediately
  • .agents/ and .claude/ appear greyed out in file tree
  • No style-profile.json written after finalizing (only SQLite)

When finalizing a style profile, offer to copy the complete generated
skill to ~/.claude/skills/my-writing-style/ so Claude Code loads it
automatically in every project.

- Add "Save globally" prompt to the finalize flow in
  ReferenceCalibrationDialog
- Finalize endpoint accepts saveToGlobal flag, copies the full skill
  directory (SKILL.md + references/) to the global location
- Add GET /api/style-profile/user-skill endpoint to check whether a
  global skill exists (called only on explicit user action)
- Add immediate "Starting…" feedback when clicking Run Analysis
- Gitignore the docwriter-style-generator symlink
SQLite is the primary store for the style profile. The JSON file was
a legacy mirror kept for pre-SQLite migration. The read-fallback in
readStyleProfile still imports old JSON files into SQLite on first
read, but new writes go only to the database.
@shreyashankar
shreyashankar force-pushed the claude/global-style-skill-export branch from 63086da to 14f0f05 Compare August 24, 2026 06:49
@shreyashankar
shreyashankar merged commit 79721a7 into main Aug 24, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant