manage-local-skills

name

manage-local-skills

description

Analyze, standardize, validate, and sync locally maintained skills into agent skill directories with a `skills` CLI-aligned workflow. Use this skill when Codex needs to turn ad-hoc prompt or rules folders into reusable `SKILL.md`-based skills, install or sync one or more local skills from `./skills` into Claude, Cursor, CodeBuddy, Codex, or similar agent directories, or manage local skill path mappings and symlink or copy installation behavior.

Manage Local Skills

Manage locally maintained skills as reusable, standard skill assets.

What this skill does

Use this skill to:

• classify local sources as standard skills, non-standard skill-like folders, or mixed repositories
• convert non-standard local materials into a standard SKILL.md-based structure
• validate standard skill structure before installation
• sync one or more local skills into one or more agent skill directories
• maintain explicit agent and IDE path mappings for local skill installation

Do not use this skill for

• publishing remote skills registries or package indexes
• cloning skills from remote repositories
• interactive marketplace search
• generic documentation cleanup unrelated to local skill structure

Workflow

1. Identify whether the user wants analysis only, migration, validation, mapping changes, or installation.
2. If the source is not obviously standard, read references/source-classification.md and run scripts/inspect-source.mjs first.
3. If migration is needed, read references/migration-playbook.md and convert the source into a standard skill folder before installation.
4. Before mounting a skill, read references/cli-alignment.md and references/install-workflow.md to preserve the source-first install model used in this repo.
5. Use scripts/validate-skill.mjs before and after installation when structure or path correctness is in doubt.
6. If the target agent is new or unclear, read references/mapping-extension.md before adding or changing mappings.

Common requests

• "Install this local skill into Claude and Cursor."
• "Sync everything under ./skills to Codex and CodeBuddy."
• "Turn this prompts folder into a reusable skill."
• "Link my local skills into the agent directories for this project."

Routing

Task	Read	Script
Understand how this differs from or aligns with skills CLI	references/cli-alignment.md
Classify local sources and detect migration candidates	references/source-classification.md	scripts/inspect-source.mjs
Convert non-standard local folders into standard skills	references/migration-playbook.md	scripts/inspect-source.mjs
Install or mount local skills into agent directories	references/install-workflow.md	scripts/install-skill.mjs
Add or update agent mappings	references/mapping-extension.md	scripts/install-skill.mjs
Validate structure or installation results	references/install-workflow.md	scripts/validate-skill.mjs

Operating rules

• Treat skills CLI installation semantics as the baseline, but follow this repo's source-first project install model for locally maintained skills.
• Prefer analysis first when the source structure is ambiguous.
• Do not execute arbitrary scripts from the source folder while inspecting it.
• In symlink mode, keep skills/ as the single maintained source of truth and expose .agents entries as links instead of extra copies.
• Prefer symlinks when supported and safe. Fall back to copy when the user requests it or symlinks fail.
• Make scope explicit: project means the current workspace, global means the user-level agent directory.
• Ask the user to confirm before writing files, replacing existing installs, changing mappings, or converting a non-standard source into a standard skill.
• If the user asks to sync multiple skills or multiple agents, summarize the planned batch operation before execution and wait for confirmation.
• Call out differences whenever the requested behavior cannot fully match skills CLI.

Quick commands

node skills/manage-local-skills/scripts/inspect-source.mjs --input <path> --json
node skills/manage-local-skills/scripts/validate-skill.mjs --skill-dir <path>
node skills/manage-local-skills/scripts/install-skill.mjs --source-dir skills --skill <name> --agent cursor --scope project --mode symlink

Minimum self-check

• Is the source clearly classified as standard, nonstandard, or mixed?
• Is the target skill structure valid before installation?
• If symlink mode was requested, does the installed .agents entry resolve back to the maintained source?
• Is the selected agent mapping explicit and correct for the requested scope?
• If symlink mode is used, is there a defined fallback to copy mode?
• If behavior differs from skills CLI, did you state the difference clearly?