project-skills

Copies selected domain skills from a local skills-stroage library into a project's .agents/skills directory.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill project-skills-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-skills
Source: https://github.com/kkkaoru/dotfiles/tree/main/.agents/skills/project-skills
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill project-skills-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing optional, domain-specific agent skills across many projects is error-prone: copying the wrong directory, installing into the shared global location, or pulling in symlinked content can break agent setups. This Skill provides a reviewed, guarded workflow for listing available skills in a local storage library and installing only the chosen ones into a specific project. ## Core Features & Use Cases - Storage Listing: Enumerates every valid skill (directories containing SKILL.md) in ~/.agents/skills-stroage via the manage.sh list command. - Guarded Installation: The manage.sh add command validates absolute project paths, skill ID format, symlink-free sources and destinations, and refuses to overwrite existing installs or install into the shared global directory. - Dependency Awareness: Guides review of prerequisite skills (e.g., Apple app skills require apple-pro-apps; Cloudflare skills may require cloudflare and workers-best-practices) before installation. - Use Case: You are setting up a Cloudflare Workers project and want domain guidance. List the storage library, review the cloudflare and workers-best-practices SKILL.md files, then install each into your project's .agents/skills with one command per skill. ## Quick Start Ask the agent to list the skills available in the local skills-stroage library and add the cloudflare skill to your project at its absolute path.

Frequently Asked Questions about project-skills

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

FAQPage Schema
How do I add a project-specific skill to my agent setup?

Run manage.sh add with the absolute project path and the skill ID, for example bash scripts/manage.sh add /absolute/project cloudflare. The helper copies the complete skill into .agents/skills and refuses existing destinations or symlinked content.

How do I list locally available skills before installing?

Run bash scripts/manage.sh list from the project-skills directory. It prints every directory in ~/.agents/skills-stroage that contains a SKILL.md file, one skill ID per line.

Can I install skills into the shared global ~/.agents/skills directory?

No. The helper explicitly refuses to install into the shared global location that contains the storage library. Optional domain skills belong in individual projects, not global startup discovery.

Why does skill installation fail with a symlink error?

The helper rejects symlinked source skills, symlinks inside skill contents, and symlinked .agents or skills directories in the destination. Review the skill manually and copy real files instead of links.

Do installed project skills update automatically when storage changes?

No. Project copies do not auto-update and the helper has no force, update, or remove operation. Compare the project copy with storage, preserve local modifications, and get permission before replacing it.