README: add a beginner-facing "Using a skill" section - #8
Merged
Conversation
The Installation section documented where skill directories go but not how to use one. Adds a section covering what a skill is and that it activates from the task description rather than a command, copy-pasteable install for the personal and project cases, the restart-and-verify step, and a short troubleshooting list. Uses a symlink into a catalog clone so `git pull` updates every install, and includes `mkdir -p` because the skills directory usually does not exist yet. Closes #7 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PWNNtH96UwEc4qrRkQtXuS
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #7
The README documented where skill directories go for each agent, but not how
to use one. Adds a Using a skill section before Installation, aimed at
people who have not used Agent Skills before.
Covers:
a command — the most common beginner confusion;
catalog clone so
git pullupdates every install;mid-session install appears to do nothing;
Includes
mkdir -pin the install commands because the skills directoryusually does not exist yet and
ln -sfails confusingly without it.The existing Installation section, its per-agent paths, and its warning that
upstream locations change are unchanged.
Checklist
SKILL.md. (no skill changed)deprecated, or removed. (no catalog change)
🤖 Generated with Claude Code
https://claude.ai/code/session_01PWNNtH96UwEc4qrRkQtXuS