stark-ai-de/agent-skills / incubator/skills/skill-maintenance/skill-installation-support
skill-installation-support
VerifiedHelp install, list, update, remove, or troubleshoot Agent Skills using the Vercel skills CLI. Use when the user asks about npx skills add, installing a whole repo, installing one skill, global vs project installs, symlink vs copy, or Codex/Claude/Cursor agent targets.
Skill Installation Support
Goal
Help users install, list, update, remove, and troubleshoot Agent Skills with clear commands and safe distinctions between local, global, and agent-specific installation.
When to use
- The user asks how to install a skills repo or one skill.
npx skills@latest addfails or does not discover expected skills.- The user asks about Codex, Claude Code, Cursor, or all-agent installation targets.
When not to use
- The user wants to create or review a skill; use
skill-authoring-review. - The user wants to maintain this repository's catalog or release state; use
skill-repo-curator. - The source skill has unclear provenance or license and should not be installed yet.
Inputs
- Repository path or GitHub owner/repo.
- Desired skill name, target agent, and global or project install preference.
- Error output from
npx skills@latest. - Local
skills/tree andSKILL.mdfrontmatter when troubleshooting discovery.
Inputs to inspect
- Inspect the source path or repository, requested skill name, target agent, global/project scope, and CLI error output.
- Check
SKILL.mdnames and descriptions when discovery fails.
Process
- Identify source: local folder, GitHub repo, full Git URL, or specific skill.
- List skills before installing when the source is unfamiliar.
- Choose global or project install based on the user's scope.
- Choose target agent flag based on the user's runtime.
- Troubleshoot discovery by checking folder structure,
SKILL.md, name matching, and CLI output. - Avoid global installation or overwrites without user approval.
Workflow
Follow the process above, then return a copy-pasteable command plus a verification command before suggesting any global install.
Decision points
- Use
--listbefore installation for unfamiliar repos. - Use
--skill <name>when installing one skill from a multi-skill repo. - Use
--allonly when the user wants all supported agents. - Prefer local folder install for testing unpublished repos.
Safety rules
- Tell users to review public skills before installing them.
- Do not install globally unless the user requested or approved it.
- Do not run commands that overwrite existing local skills without approval.
References
Read references/vercel-skills-cli.md when the user needs command examples or troubleshooting steps.
Scripts
No bundled scripts.
Output format
Return:
- Recommended command
- What it installs
- Scope and target agent
- Verification command
- Troubleshooting notes
Failure modes
- If the CLI is unavailable, give the install prerequisite and a no-op discovery check.
- If the skill name is not found, list available skills from the source.
- If global installation is risky, recommend project-local installation first.
Completion criteria
- The user has an exact command for their source and target agent.
- Safety and scope are explicit.
- Discovery or installation failure has a concrete next diagnostic step.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |