@kurokeita/add-skill 1.19.0 → 1.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -36,6 +36,10 @@ List locally installed items:
36
36
  ```bash
37
37
  pnpx @kurokeita/add-skill list --local
38
38
  pnpx @kurokeita/add-skill list agent --local
39
+
40
+ # Pick a scope non-interactively (default: global)
41
+ pnpx @kurokeita/add-skill list --local --scope project
42
+ pnpx @kurokeita/add-skill list --local --scope both
39
43
  ```
40
44
 
41
45
  ### Add Items
@@ -51,6 +55,11 @@ pnpx @kurokeita/add-skill add agent
51
55
 
52
56
  # Add workflows
53
57
  pnpx @kurokeita/add-skill add workflow
58
+
59
+ # Install at project scope (writes under the current directory's
60
+ # `.<platform>/...` paths instead of `~/...`). Project scope is
61
+ # refused at $HOME or outside a git work tree.
62
+ pnpx @kurokeita/add-skill add --scope project
54
63
  ```
55
64
 
56
65
  ### Remove Items
@@ -63,6 +72,10 @@ pnpx @kurokeita/add-skill remove skill
63
72
 
64
73
  # Remove agents
65
74
  pnpx @kurokeita/add-skill remove agent
75
+
76
+ # Pick a scope non-interactively
77
+ pnpx @kurokeita/add-skill remove skill --scope project
78
+ pnpx @kurokeita/add-skill remove skill --scope both
66
79
  ```
67
80
 
68
81
  ### Add Item from GitHub
@@ -96,6 +109,23 @@ pnpm dev import https://github.com/owner/repo/tree/main/skills/skill-name
96
109
 
97
110
  For Codex, this package installs skills directly and converts agents and workflows into Codex skill packages under `~/.codex/skills`.
98
111
 
112
+ ### Project-scope paths
113
+
114
+ When you pick `--scope project`, items are written under the current working directory instead of `~`. The mapping below uses `<project-root>` to mean `process.cwd()` (no git-toplevel relocation: a monorepo subdirectory installs into that subdirectory, not the repo root).
115
+
116
+ <!-- PROJECT_SCOPE_PATHS_START -->
117
+ | Platform | Agents Path | Skills Path | Workflows Path |
118
+ | :--- | :--- | :--- | :--- |
119
+ | Antigravity | *Not Supported* | `<project-root>/.gemini/antigravity/skills` | `<project-root>/.gemini/antigravity/workflows` |
120
+ | Claude Code | `<project-root>/.claude/agents` | `<project-root>/.claude/skills` | `<project-root>/.claude/skills` |
121
+ | Codex | `<project-root>/.codex/skills` | `<project-root>/.codex/skills` | `<project-root>/.codex/skills` |
122
+ | Gemini CLI | `<project-root>/.gemini/agents` | `<project-root>/.gemini/skills` | `<project-root>/.gemini/commands` |
123
+ | GitHub Copilot | `<project-root>/.copilot/agents` | `<project-root>/.copilot/skills` | `<project-root>/.copilot/prompts` |
124
+ | Windsurf | *Not Supported* | `<project-root>/.codeium/windsurf/skills` | `<project-root>/.codeium/windsurf/workflows` |
125
+ <!-- PROJECT_SCOPE_PATHS_END -->
126
+
127
+ Project scope is refused when `cwd` equals your home directory or `cwd` is not inside a git work tree. When refused interactively, you can fall back to global scope without losing your already-selected items and platforms.
128
+
99
129
  ## Development
100
130
 
101
131
  1. **Clone the repository:**