Skip to content

Make example-skills-catalog catalog recording optional - #69

Merged
dmccoystephenson merged 1 commit into
mainfrom
feature/optional-my-claude-skills
Jul 27, 2026
Merged

Make example-skills-catalog catalog recording optional#69
dmccoystephenson merged 1 commit into
mainfrom
feature/optional-my-claude-skills

Conversation

@dmccoystephenson

@dmccoystephenson dmccoystephenson commented Jul 27, 2026

Copy link
Copy Markdown
Member

Summary

  • Step 7 assumed every user maintains a ~/example-skills-catalog catalog repo and unconditionally cds into it — for anyone without that repo, this would hard-fail generation right after Steps 1-6 already did real work (GitHub repo created, labels seeded, slash command registered).
  • Now checks [ -d ~/example-skills-catalog/.git ] first. If present, records the skill as before. If absent, skips silently — Step 5 already registered the slash command, so the generated skill is fully functional without a catalog entry.
  • Updated README's Step 7 description and the update-mode bullet to reflect the optionality.

Why

Flagged during OSS-readiness review: ~/local-skills/ (Steps 1/3/5) already degrades gracefully via mkdir -p, but ~/example-skills-catalog/ (Step 7) did not. This was the one remaining hard external-contributor blocker from the OSS-prep audit.

Test plan

  • python3 scripts/check_docs.py passes
  • No new {{placeholder}} introduced
  • Traced Step 7 logic manually for both the present and absent case

drafted by Claude on behalf of Daniel Stephenson

Step 7 previously assumed every user maintains a ~/my-claude-skills
catalog repo and would hard-fail (cd into a nonexistent directory)
for anyone who doesn't. Check for its existence first and skip
silently when absent -- it's a personal convenience convention, not
required for the generated skill to work.
@dmccoystephenson
dmccoystephenson merged commit e1a4a8c into main Jul 27, 2026
1 check passed
@dmccoystephenson
dmccoystephenson deleted the feature/optional-my-claude-skills branch July 27, 2026 01:52
dmccoystephenson added a commit that referenced this pull request Jul 27, 2026
…nce (#77)

Step 1 told the generator to diff against /tmp/<slug>-dev-loop.new.md
but never said how that file gets written -- the natural reading was
shell redirection, which is exactly what PR #67 documented as blocked
in some sandboxes, and /tmp is outside the repo directory some
sandboxes also restrict. Now names the Write tool and an in-repo
scratch path, and fails closed (abort, don't overwrite unreviewed) if
the write itself fails.

Also updated Step 1's MODE=update bullet, which still said 'record in
my-claude-skills' after PR #69 renamed Step 7 to an optional personal
catalog.

Closes #73
@dmccoystephenson dmccoystephenson changed the title Make my-claude-skills catalog recording optional Make example-skills-catalog catalog recording optional Jul 27, 2026
dmccoystephenson added a commit that referenced this pull request Aug 3, 2026
Step 7 previously assumed every user maintains a ~/a-private-repo-3
catalog repo and would hard-fail (cd into a nonexistent directory)
for anyone who doesn't. Check for its existence first and skip
silently when absent -- it's a personal convenience convention, not
required for the generated skill to work.
dmccoystephenson added a commit that referenced this pull request Aug 3, 2026
…nce (#77)

Step 1 told the generator to diff against /tmp/<slug>-dev-loop.new.md
but never said how that file gets written -- the natural reading was
shell redirection, which is exactly what PR #67 documented as blocked
in some sandboxes, and /tmp is outside the repo directory some
sandboxes also restrict. Now names the Write tool and an in-repo
scratch path, and fails closed (abort, don't overwrite unreviewed) if
the write itself fails.

Also updated Step 1's MODE=update bullet, which still said 'record in
a-private-repo-3' after PR #69 renamed Step 7 to an optional personal
catalog.

Closes #73
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