Skip to content

README: add a beginner-facing "Using a skill" section - #8

Merged
eeholmes merged 1 commit into
mainfrom
docs/using-a-skill
Sep 3, 2026
Merged

README: add a beginner-facing "Using a skill" section#8
eeholmes merged 1 commit into
mainfrom
docs/using-a-skill

Conversation

@eeholmes

@eeholmes eeholmes commented Sep 3, 2026

Copy link
Copy Markdown
Member

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:

  • what a skill is, and that it activates from the task description rather than
    a command — the most common beginner confusion;
  • copy-pasteable install for the personal and project cases, symlinking into a
    catalog clone so git pull updates every install;
  • the restart requirement, since skills are discovered at session start and a
    mid-session install appears to do nothing;
  • how to verify, and a short "it did not trigger" fallback.

Includes mkdir -p in the install commands because the skills directory
usually does not exist yet and ln -s fails confusingly without it.

The existing Installation section, its per-agent paths, and its warning that
upstream locations change are unchanged.

Checklist

  • The relevant issue is linked.
  • The maturity level is appropriate. (no skill changed)
  • Each changed skill has a valid SKILL.md. (no skill changed)
  • Core instructions are concise and references are used appropriately.
  • Bundled scripts are tested, or no scripts changed. (no scripts)
  • Evaluations are added or updated when behavior changes. (no behavior change)
  • Current official documentation was checked where relevant.
  • No secrets or sensitive information are included.
  • The README catalog is updated if a skill was added, renamed, stabilized,
    deprecated, or removed. (no catalog change)

🤖 Generated with Claude Code

https://claude.ai/code/session_01PWNNtH96UwEc4qrRkQtXuS

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
@eeholmes
eeholmes merged commit 4326b75 into main Sep 3, 2026
1 check passed
@eeholmes
eeholmes deleted the docs/using-a-skill branch September 3, 2026 21:43
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.

README: add a beginner-facing "Using a skill" section

1 participant