wantsong
/
skills-vault
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
skills-vault/docs/installation.md

2.9 KiB
Raw Blame History

Installation

This repository separates Skill development source from the local public installation surface.

Paths

Development source:

C:\Users\wangq\Documents\Codex\skills-vault

Public local Skill installation surface:

C:\Users\wangq\.agents\skills

Agent-specific private Skill folders, such as C:\Users\wangq\.claude\skills, should link to the public installation surface instead of linking directly to the development source.

Conda Environment

Use the shared repository environment by default:

conda env create -f environment.yml
conda activate skills-vault

If the environment already exists:

conda activate skills-vault

If conda env create -f environment.yml fails in Codex or another non-interactive Windows shell because of progress output, solver plugin, or root environment directory issues, create the environment explicitly under the user env directory:

C:\Users\wangq\miniconda3\Scripts\conda.exe create -p C:\Users\wangq\.conda\envs\skills-vault python=3.11 pip -y --json --solver classic

Then use:

conda activate C:\Users\wangq\.conda\envs\skills-vault

Most lightweight Skills should use this shared environment. Create a dedicated environment only when a Skill has conflicting or heavy dependencies.

Install One Skill

PowerShell:

powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -Skill fix-title

Git Bash / Linux / macOS:

bash scripts/install-skill.sh fix-title

Install All Default Skills

PowerShell:

powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -All

Git Bash / Linux / macOS:

bash scripts/install-skill.sh --all

Full installation uses registry/skills-index.md and installs only Skills with:

Status: tested, installable, or installed
Install Policy: default

Conditional, optional, disabled, deprecated, and archived Skills are skipped during full installation.

Updating An Existing Installed Skill

By default, install scripts refuse to overwrite an existing Skill.

Use -Force or --force to back up the current installed directory and copy the repository version:

powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -Skill fix-title -Force

bash scripts/install-skill.sh fix-title --force

Backups are created next to the installed Skill:

C:\Users\wangq\.agents\skills\fix-title.backup-YYYYMMDDHHMMSS

Claude Link

To create or update the Claude private Skill entry as a link to the public installation surface:

powershell -ExecutionPolicy Bypass -File .\scripts\install-skill.ps1 -Skill fix-title -InstallClaudeLink

bash scripts/install-skill.sh fix-title --install-claude-link

Codex is not currently treated as a separate private install target for these shared automation Skills.