{"id":"malo-find-skills","name":"malo-find-skills","summary":"「Xのスキルはどうやってやるの?」「Xのスキルはあるのか?」「能力拡張に興味があるのか」といった質問をした際に、エージェントスキルを発見しインストールするのを支援します。","body":"# Find Skills\n\nThis skill helps you discover and install skills from the open agent skills ecosystem (https://skills.sh). Based on the [find-skills](https://github.com/vercel-labs/skills/tree/main/skills/find-skills) skill by Vercel, adapted for this Nix-managed environment.\n\n## When to Use This Skill\n\nUse this skill when the user:\n\n- Asks \"how do I do X\" where X might be a common task with an existing skill\n- Says \"find a skill for X\" or \"is there a skill for X\"\n- Asks \"can you do X\" where X is a specialized capability\n- Expresses interest in extending agent capabilities\n- Wants to search for tools, templates, or workflows\n\n## How Skills Work in This Setup\n\nAll paths below (e.g. `home/claude.nix`, `configs/claude/skills/`) are relative to the nix-config directory.\n\nSkills are split into two categories:\n\n- **Custom skills**: Directories in `configs/claude/skills/` committed to the nix-config repo. These are skills we author and maintain.\n- **External skills**: Installed from skills.sh via `npx skills add`. These are managed by an activation script in `home/claude.nix` and are gitignored (they appear as symlinks in the skills directory, not regular directories).\n\nThe activation script defines a list called `externalSkills`. On every `nh darwin switch --no-nom`, it removes all Claude Code external skills and reinstalls only the declared ones. This keeps external skills declarative and reproducible.\n\n## Finding Skills\n\n### Step 1: Search\n\nRun the find command with a relevant query:\n\n```bash\nnpx skills find [query]\n```\n\nFor example:\n\n- \"how do I make my React app faster?\" -> `npx skills find react performance`\n- \"can you help me with PR reviews?\" -> `npx skills find pr review`\n- \"I need to create a changelog\" -> `npx skills find changelog`\n\nYou can also browse skills at https://skills.sh/\n\n### Step 2: Present Options\n\nWhen you find relevant skills, present them with:\n\n1. The skill name and what it does\n2. The install command\n3. A link to learn more\n\n### Step 3: Install\n\nTo try a skill immediately:\n\n```bash\nnpx skills add <owner/repo> --skill <name> -g -a claude-code -y\n```\n\nAlways pass `-a claude-code` to avoid installing for other agents. The `-g` flag installs globally (user-level) and `-y` skips prompts.\n\n### Step 4: Make It Permanent\n\nIf the user wants to keep the skill across rebuilds, add it to the `externalSkills` list in `home/claude.nix`:\n\n```nix\nexternalSkills = [\n  \"anthropics/skills --skill pdf\"\n  \"owner/repo --skill new-skill\"  # <- add here\n];\n```\n\nThen `nh darwin switch --no-nom` will install it on every activation.\n\n## Creating a Custom Skill\n\nIf no existing skill fits, or the user wants to build their own:\n\n1. Create a directory in `configs/claude/skills/<skill-name>/`\n2. Add a `SKILL.md` with YAML frontmatter (`name` and `description`) and instructions\n3. The gitignore allowlists directories automatically, so it will be tracked in git\n4. Optionally add `references/`, `scripts/`, or other supporting files\n\n## When No Skills Are Found\n\nIf no relevant skills exist:\n\n1. Acknowledge that no existing skill was found\n2. Offer to help with the task directly\n3. Suggest creating a custom skill if it's a repeatable workflow","author":"@malob","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/malob/nix-config/tree/master/configs/claude/skills/malo-find-skills","license":"MIT","category":"productivity","lang":"en","tokens":804,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":["skills.sh"]}}