Skip to content

fix: resolve four local skills onboarding friction points#43

Merged
scotthavird merged 1 commit intomainfrom
fix/local-skills-onboarding-friction
Apr 11, 2026
Merged

fix: resolve four local skills onboarding friction points#43
scotthavird merged 1 commit intomainfrom
fix/local-skills-onboarding-friction

Conversation

@scotthavird
Copy link
Copy Markdown
Contributor

Summary

Four friction points in promptconduit skills generate --local that would cause silent failures or confusing errors for first-time users (e.g., from a Show HN post).

Changes

cmd/skills.go

  • Register --dry-run flag on skillsGenerateCmd (was documented in README and DocsPage but never wired up — silently ignored)
  • Fix URL: promptconduit.io/skillspromptconduit.dev/skills

cmd/skills_local.go

  • Repo filter diagnostic: when --repo auto-detection filters all transcripts to zero, now returns an actionable error explaining how many global transcripts exist and how to use --repo='' to opt out. Previously silently fell through to the 5-conv guard with a confusing message.
  • 5-conv minimum messaging: distinguishes "not enough new transcripts since last run" (explains --force) from "not enough total transcripts" (explains to use Claude Code more). Previous message was ambiguous.
  • Dry-run implementation: after AI detection, check skillsDryRun and call new outputLocalSkillsDryRun instead of writing files. Shows what would be written with predicted paths.
  • Write failure accuracy: outputLocalSkillsGenerated previously printed "N skills written" even when all writes failed. Now marks unwritten skills inline with "Not written (see errors below)", reports "N of M skills written" for partial success, and prints an actionable stderr error when 0 were written.

Testing

  • make build — compiles cleanly
  • make test — all tests pass

- Add --dry-run flag to `skills generate` (was documented but unimplemented;
  silently ignored on every invocation)
- Add diagnostic error when repo filter yields zero transcripts: tells user
  how many global transcripts exist and how to opt out with --repo=''
- Improve 5-conversation minimum messaging: distinguishes "not enough new
  transcripts" from "not enough total" and explains --force clearly
- Fix outputLocalSkillsGenerated to accurately report write failures: marks
  unwritten skills inline, shows "N of M skills written" when partial, and
  prints an actionable error when 0 were written (was silently reporting success)
- Fix URL: promptconduit.io/skills → promptconduit.dev/skills

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@scotthavird scotthavird merged commit 943c78c into main Apr 11, 2026
1 check passed
@scotthavird scotthavird deleted the fix/local-skills-onboarding-friction branch April 11, 2026 01:36
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