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

Ready to run

npx skills add https://github.com/jeff-hamm/ai-tools --skill link-skill

💬 Prompt for ChatGPT / Claude Chat▼

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.