{"_id":"@amanm/skiller","name":"@amanm/skiller","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@amanm/skiller","version":"0.1.0","description":"fuzzy-search skills.sh and install agent skills from anywhere — one keybinding away on Omarchy","license":"MIT","author":{"name":"amanmprojects"},"repository":{"type":"git","url":"git+https://github.com/amanmprojects/skiller.git"},"homepage":"https://github.com/amanmprojects/skiller#readme","bugs":{"url":"https://github.com/amanmprojects/skiller/issues"},"keywords":["skills","skills-sh","claude","agent-skills","fzf","omarchy","hyprland","cli"],"bin":{"skiller":"bin/skiller","skiller-launcher":"bin/skiller-launcher"},"os":["linux","darwin"],"gitHead":"15ab8850b2a36665558210e6a5ba7626eb865e57","_id":"@amanm/skiller@0.1.0","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-kqJu2K3EIzBLtC7WWvAn9opEHo0qT4ZeR/d8JEzo5mazvzOTcDgFD7wpzcQsdD93dCXS6FhuQ1FReiAjqoqL/A==","shasum":"f5f9171733e5f747c66985655c24877eb218c077","tarball":"https://registry.npmjs.org/@amanm/skiller/-/skiller-0.1.0.tgz","fileCount":5,"unpackedSize":22497,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBIHX8xdE2jM+NfcMjGNZ6ueY7psw4VpSf//pSu6zuuxAiApoUaNUFapB9N82A6dYarhcqRIXJntYOk0uloQMPNbww=="}]},"_npmUser":{"name":"aman-mehtar","email":"amanmstudies@gmail.com"},"directories":{},"maintainers":[{"name":"aman-mehtar","email":"amanmstudies@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skiller_0.1.0_1787419440194_0.6955863410676308"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T17:24:00.033Z","0.1.0":"2026-08-22T17:24:00.330Z","modified":"2026-08-22T17:24:00.507Z"},"maintainers":[{"name":"aman-mehtar","email":"amanmstudies@gmail.com"}],"description":"fuzzy-search skills.sh and install agent skills from anywhere — one keybinding away on Omarchy","homepage":"https://github.com/amanmprojects/skiller#readme","keywords":["skills","skills-sh","claude","agent-skills","fzf","omarchy","hyprland","cli"],"repository":{"type":"git","url":"git+https://github.com/amanmprojects/skiller.git"},"author":{"name":"amanmprojects"},"bugs":{"url":"https://github.com/amanmprojects/skiller/issues"},"license":"MIT","readme":"# Skiller\n\nFuzzy-search [skills.sh](https://skills.sh) and install agent skills from anywhere — built for [Omarchy](https://omarchy.org), happy in any terminal.\n\nPress one key, get a floating picker that searches skills.sh **as you type**, previews the SKILL.md, and installs the skill into whatever directory you're standing in.\n\n```\n┌──────────────────────────────────────────────────┬───────────────────┐\n│ skills> 1/50                              react… │ SKILL.md          │\n│   650K  vercel-react-best-practices  vercel-labs │ # React Best      │\n│   191K  vercel-react-native-skills   vercel-labs │ # Practices       │\n│   102K  vercel-react-view-transit…   vercel-labs │ Comprehensive     │\n└──────────────────────────────────────────────────┴───────────────────┘\n```\n\n## Keys\n\n| Key | Action |\n|-----|--------|\n| <kbd>G</kbd> | toggle install scope: `local` ↔ `global` (shown in the prompt) |\n| <kbd>R</kbd> | remove mode — lists installed skills for the current scope; <kbd>Enter</kbd> removes |\n| <kbd>Enter</kbd> | install (or remove, in remove mode) |\n| <kbd>O</kbd> | open the selected skill on skills.sh (picker stays open) |\n| <kbd>Esc</kbd> | quit |\n\nInstall = `npx skills add <owner/repo>@<skill> -y` (plus `-g` when global). Remove = `npx skills remove`.\n\n## Install\n\nRequirements: `bash`, `fzf`, `jq`, `curl`, and Node/npx (nvm and mise are auto-detected; anything that puts `npx` on PATH works).\n\nVia npm:\n\n```bash\nnpm i -g @amanm/skiller     # puts `skiller` on your PATH\n# or one-shot:\nnpx @amanm/skiller [query]\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/amanmprojects/skiller\ncd skiller\n./install.sh\n```\n\nThe script copies two executables into `~/.local/bin`:\n\n- `skiller` — the picker (also usable directly: `skiller [query]`)\n- `skiller-launcher` — keybinding entry point; resolves your terminal's directory, then opens the picker in a new floating terminal\n\nThen wire it into Omarchy (all snippets are user-config — nothing under `/usr/share/omarchy` is touched):\n\n**Keybinding** — `~/.config/hypr/bindings.lua`:\n```lua\no.bind(\"SUPER + I\", \"Skiller\", \"skiller-launcher\")\n```\n\n**Floating picker window** — `~/.config/hypr/hyprland.lua`:\n```lua\no.window(\"^org\\\\.omarchy\\\\.skiller$\", { float = true, center = true, size = { 1100, 720 } })\n```\n\nRun `hyprctl reload` after editing.\n\nOptional — an Omarchy-menu row, `~/.config/omarchy/extensions/omarchy-menu.jsonc`:\n```jsonc\n\"skiller\": { \"icon\": \"󰚝\", \"label\": \"Skiller\", \"action\": \"skiller-launcher\", \"description\": \"Search & install agent skills\" }\n```\n\nNo Omarchy? Just run `skiller` inside any terminal — it installs into `$PWD`.\n\n## How it knows where you are\n\nLaunched from a keybinding, nothing tells Skiller which project you're in, so the launcher resolves the focused terminal's live working directory before spawning the picker:\n\n1. **herdr terminals** — herdr runs shells under a server daemon (not under the terminal window), so Skiller asks the herdr API for the focused pane's foreground-process cwd. The client binary is located via `/proc/<pid>/exe`; no PATH assumptions.\n2. **plain terminals** — falls back to Omarchy's `omarchy-cmd-terminal-cwd` (window PID → shell child → `/proc/<pid>/cwd`).\n3. **$HOME** — if focus isn't a terminal at all.\n\nThe resolved directory is shown in the frame label (` Skiller · ~/Work/myproject `), so there's never a surprise about where a skill lands.\n\n## How search works\n\nUses skills.sh's unauthenticated JSON endpoint (`GET /api/search?q=…`) — single words fuzzy-match, multi-word queries use semantic search. Previews fetch SKILL.md from GitHub raw, with a cached git-tree lookup as fallback for repos whose directory names don't match their skills.sh slugs. Installed skills are listed from `skills-lock.json`.\n\nTested on Arch/Omarchy with Hyprland + foot + herdr. Should work on any Wayland/Linux setup with fzf; without Hyprland, just type `skiller`.\n","readmeFilename":"README.md","_rev":"1-710d22ceaf8fd581dbf34e82b2dcc822"}