ccski 0.0.0 → 1.0.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 +93 -0
- package/dist/cli.d.mts +1 -0
- package/dist/cli.mjs +23012 -0
- package/dist/cli.mjs.map +1 -0
- package/dist/index.d.mts +334 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +3 -0
- package/dist/registry-DGrbpgs5.mjs +13296 -0
- package/dist/registry-DGrbpgs5.mjs.map +1 -0
- package/package.json +58 -6
package/README.md
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# ccski – Claude Code Skills Manager
|
|
2
|
+
|
|
3
|
+
ccski is a CLI + MCP server that lets any AI coding assistant discover, install, enable/disable, and serve Claude Code-compatible skills. It is purpose-built to be lightweight, type-safe, and easy to embed in your editor or agent toolchain.
|
|
4
|
+
|
|
5
|
+
## 1) Positioning & MCP quick start
|
|
6
|
+
|
|
7
|
+
- **What it is**: a thin, batteries-included manager for SKILL.md–based skill packs (local folders, git repos, plugin marketplaces).
|
|
8
|
+
- **Who it’s for**: humans running CLI workflows and agents connecting over MCP.
|
|
9
|
+
|
|
10
|
+
### Start MCP in one line
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npx ccski mcp
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Common MCP registrations:
|
|
17
|
+
|
|
18
|
+
- **Codex CLI**: `codex mcp add skills -- npx ccski mcp`
|
|
19
|
+
- **Cursor / Windsurf / VS Code MCP plugins** (config excerpt):
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"mcpServers": {
|
|
24
|
+
"ccski": {
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["ccski", "mcp"]
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Run with `--skill-dir` to add extra roots, or `--no-refresh` to disable live reload.
|
|
33
|
+
|
|
34
|
+
## 2) Core CLI surface (human-friendly)
|
|
35
|
+
|
|
36
|
+
| Command | Purpose |
|
|
37
|
+
| ------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
|
38
|
+
| `ccski list` | Show discovered skills (projects, home, plugin marketplace) with status badges |
|
|
39
|
+
| `ccski info <name>` | Inspect metadata and preview content |
|
|
40
|
+
| `ccski install <source> [-i\|--all\|--use]` | Install skills from git/dir/marketplace; interactive picker shows final one-shot command |
|
|
41
|
+
| `ccski enable [names...] [-i\|--all]` | Restore `.SKILL.md` → `SKILL.md`; interactive defaults **unchecked** |
|
|
42
|
+
| `ccski disable [names...] [-i\|--all]` | Disable skills by flipping to `.SKILL.md` |
|
|
43
|
+
| `ccski mcp` | Start MCP server (stdio/http/sse) |
|
|
44
|
+
| `ccski validate <path>` | Validate SKILL.md or directory structure |
|
|
45
|
+
|
|
46
|
+
Interactive pickers across install/enable/disable share the same layout, colors, and live “Command:” preview so you can copy/paste the equivalent non-interactive invocation.
|
|
47
|
+
|
|
48
|
+
## 3) Thanks & lineage
|
|
49
|
+
|
|
50
|
+
- **openskills** — established the SKILL.md authoring pattern; we align with that spec for compatibility.
|
|
51
|
+
- **universal-skills** — offers a curated, ready-to-use skill set; ccski focuses on management and transport, not bundling content.
|
|
52
|
+
|
|
53
|
+
Key differences: ccski is a manager/server (no baked-in skill corpus), MCP-first, and optimized for multi-root discovery plus install/enable/disable ergonomics.
|
|
54
|
+
|
|
55
|
+
## 4) Contributing & architecture at a glance
|
|
56
|
+
|
|
57
|
+
### Fast start
|
|
58
|
+
|
|
59
|
+
- `pnpm install`
|
|
60
|
+
- `pnpm test` (Vitest)
|
|
61
|
+
- `pnpm ts` (type-check)
|
|
62
|
+
- `pnpm build` (tsdown)
|
|
63
|
+
|
|
64
|
+
### Architecture map
|
|
65
|
+
|
|
66
|
+
- Entry: `src/cli.ts` (yargs CLI, shared color flags)
|
|
67
|
+
- Commands: `src/cli/commands/*.ts`
|
|
68
|
+
- Interactive UI: `src/cli/prompts/multiSelect.ts` (shared checkbox with live command preview)
|
|
69
|
+
- Formatting: `src/utils/format.ts` (tone helpers; avoid ad-hoc colors)
|
|
70
|
+
- Skill core: `src/core/*` (discovery, registry, parsing)
|
|
71
|
+
- Tests: `tests/*.test.ts` (Vitest + bun runtime for CLI e2e)
|
|
72
|
+
|
|
73
|
+
Suggested reading order: `src/utils/format.ts` → `src/cli/prompts/multiSelect.ts` → command files (install, toggle) → `src/core/registry.ts`.
|
|
74
|
+
|
|
75
|
+
### Code style highlights
|
|
76
|
+
|
|
77
|
+
- TypeScript strict; no `any`/`as any`/`@ts-nocheck` unless unavoidable for third-party types.
|
|
78
|
+
- Keep CLI colors via `tone/heading/warn/info/success/error`; don’t hardcode colorette directly.
|
|
79
|
+
- Prefer small files (<200 lines) or refactor into folders when complexity grows.
|
|
80
|
+
- Tests: Vitest with jsdom where needed; integration tests exercise CLI via bun runner.
|
|
81
|
+
- Package manager: pnpm; scripts live in `package.json`.
|
|
82
|
+
|
|
83
|
+
### Development scripts
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
pnpm install # deps
|
|
87
|
+
pnpm test # full test suite
|
|
88
|
+
pnpm ts # type check
|
|
89
|
+
pnpm build # bundle with tsdown
|
|
90
|
+
pnpm fmt # prettier + organize imports + tailwind plugin
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Happy hacking — PRs welcome!
|
package/dist/cli.d.mts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|