skills.rest
jeff-hamm
jeff-hammCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

link-skill

Create and maintain symlinks between src/skills and ~/.agents/skills.

Updated Aug 23, 2026
Search Tags:#migration#claude#scaffold#status#skill-management#symlink#ai-tools
One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill link-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: link-skill
Source: https://github.com/jeff-hamm/ai-tools/tree/main/.agents/skills/link-skill
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill link-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you manage and activate personal Claude skills stored under src/skills by creating and maintaining symlinks into ~/.agents/skills, enabling user-scope activation and consistent tracking.

Core Features & Use Cases

  • Create a new skill under src/skills/<name> and link it into your user workspace.
  • Migrate an existing local skill to be tracked in this repo, or stop tracking while keeping a local copy.
  • Check status to differentiate between tracked (symlinked) skills and local installations, and resolve inconsistencies.

Quick Start

Scaffold or link a skill by running the link-skill script to ensure the skill is tracked and activated via a symlink.

Frequently Asked Questions about link-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create symlinks to manage personal Claude skills in a local repository?▼

To manage personal Claude skills, you can create symlinks between your src/skills directory and ~/.agents/skills to enable user-scope activation and consistent tracking across your workspace.

What's the best way to migrate a local Claude skill to a tracked repository?▼

Migrating a local Claude skill involves using a link script to move the skill into src/skills and creating a symlink, which allows you to track it in the repository while keeping it active locally.

How can I check the status of tracked versus local Claude skills?▼

You can check the status of Claude skills by running a validation script that differentiates between tracked symlinked skills in the repository and local installations, helping resolve inconsistencies.

Can I stop tracking a Claude skill while keeping a local copy active?▼

Yes, you can unlink a Claude skill to stop tracking it in the repository while preserving your local copy, removing the symlink without deleting the underlying skill files from your workspace.

Do I need a specific file format to scaffold a new Claude skill for symlink management?▼

Yes, scaffolding a new Claude skill requires specifying YAML frontmatter with a name and description in a SKILL.md file, which the link script uses to create and maintain the necessary symlinks.

Why are my personal Claude skills not activating in my user workspace?▼

Claude skills may fail to activate if the symlink between src/skills and ~/.agents/skills is broken or missing, so running a status check helps identify and resolve tracking inconsistencies.

Related Skills

Explore More Software Engineering Skills→
PPstevenPPsteven
1

new-skill

Create and deploy new skills with directory structure and symlink verification.

Community
Intermediate
PlaneInABottlePlaneInABottle

skill-maintainer

Audit local skills trees for inconsistencies and broken references.

Community
Advanced
tabooestabooes
1

skill-authoring-workflow

Convert rough notes into compliant SKILL.md files using repository scripts.

Community
Advanced
EmrebenerEmrebener

installing-sublime-skills

Recreate and repoint symlinks for Sublime-Skills under Claude Code and Codex.

Community
Basic