# Skill Valet

> Use when the session feels bloated or slow, the user mentions "too many skills", "context bloat", "skill list is huge", asks why a skill disappeared or isn't available, or wants to manually park/unpark skill groups mid-session. skill-valet automatically moves unused user-skill directories out of ~/.claude/skills so the per-turn skill list stays lean, and brings them back the moment a prompt needs…

- **Type:** Skill
- **Install:** `agentstack add skill-sdeenadmin-skill-valet-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SDeenAdmin](https://agentstack.voostack.com/s/sdeenadmin)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SDeenAdmin](https://github.com/SDeenAdmin)
- **Source:** https://github.com/SDeenAdmin/skill-valet/tree/main/skill

## Install

```sh
agentstack add skill-sdeenadmin-skill-valet-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# skill-valet

skill-valet is a UserPromptSubmit hook that keeps the per-turn skill list
lean. It keyword-classifies each prompt into skill **groups** (defined in
`~/.claude/skill-valet.json`), moves a group's skill directories back into
`~/.claude/skills/` when the prompt needs them, and parks groups that have
been idle for `park_after` turns (default 20) into `~/.claude/skills-off/`.

## When invoked, do this

1. Run `python3 /skill_valet.py status` to show the user which
   groups are ON / PARKED / PARTIAL, the turn counter, and idle times.
2. If the user asks why a skill is missing: check whether it belongs to a
   parked group (status output) or sits in `~/.claude/skills-off/`.
3. Manual overrides on request:
   - `on ` / `off ` — force a group in or out now
   - `all-on` — restore every managed skill
   - `pause` / `resume` — kill switch: while paused the hook does nothing
4. To change what is managed: edit `~/.claude/skill-valet.json` — move a
   skill name between `always_on` (never touched) and a group's `skills`
   list, or tune the group's `keywords`.

## Honest boundaries — state these when relevant

- **Next-turn effect, not same-turn.** A skill un-parked by this prompt
  appears in the skill list from the NEXT turn onward. If the user needs a
  parked skill right now, run `on ` and ask them to re-send the
  request.
- **User skills only.** Plugins, plugin skills, and MCP servers are bound
  to session start — skill-valet cannot switch those mid-session; a restart
  (or profile switcher) is required.
- **Hooks are NEVER touched — by design.** Hooks are the user's
  deterministic safety layer; skill-valet has no code path that reads or
  modifies them.
- **Multi-session caveat.** Directory moves are global: parking a group
  affects every concurrently running Claude Code session on this machine.
- **Fail-open.** If the hook errors it silently does nothing (exit 0) — it
  will never block a prompt. If behavior seems off, check
  `~/.claude/skill-valet-state.json` and the config for JSON validity.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SDeenAdmin](https://github.com/SDeenAdmin)
- **Source:** [SDeenAdmin/skill-valet](https://github.com/SDeenAdmin/skill-valet)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sdeenadmin-skill-valet-skill
- Seller: https://agentstack.voostack.com/s/sdeenadmin
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.