@ccoalm/ccl-skills 0.6.1 → 0.6.2
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 +55 -15
- package/dist/assets/release.json +3 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,12 +1,16 @@
|
|
|
1
1
|
# @ccoalm/ccl-skills
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/@ccoalm/ccl-skills)
|
|
4
|
+
[](https://www.npmjs.com/package/@ccoalm/ccl-skills)
|
|
5
|
+
[](https://github.com/ccoalm/ccl-skills/blob/main/LICENSE)
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
**Reusable workflows that help coding agents plan, build, test, review, and release software.**
|
|
6
8
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
-
|
|
9
|
+
Not a prompt pack — a routed delivery system. 32 skills cover the whole lifecycle, and a routing layer reads what you asked for and hands it to the skill that owns that deliverable, so you never look one up.
|
|
10
|
+
|
|
11
|
+
Ask it to fix a bug and `defect-diagnosis` takes over: reproduce from first-hand failure evidence, isolate the cause, verify the fix, leave a regression test behind. Ask for a feature and `product-rd-workflow` routes it through requirement shaping, risk gates, implementation, and release. Ask it to touch code at all and `worktree-isolation` puts the work on its own branch first. Every skill also states when *not* to use it and which one to use instead — that is what keeps the routing sharp.
|
|
12
|
+
|
|
13
|
+
Each skill is a method, not a suggestion, and it ships with the gate that protects it. The methods are what worked, written down. The gates are what went wrong, turned into a stop: no patch before a reproduction, no edit on `main`, no *done* without evidence. A routing eval bank and CI gates check that both still fire.
|
|
10
14
|
|
|
11
15
|
## Install
|
|
12
16
|
|
|
@@ -15,24 +19,50 @@ npm install --global @ccoalm/ccl-skills
|
|
|
15
19
|
ccl-skills install
|
|
16
20
|
```
|
|
17
21
|
|
|
18
|
-
|
|
22
|
+
Restart your CLI so it reloads the skills.
|
|
23
|
+
|
|
24
|
+
`install` configures every host it detects. The package carries an immutable snapshot of the skills, agent context, plugin manifests, and runtime hooks, so installation needs no Git checkout.
|
|
25
|
+
|
|
26
|
+
Requirements: Node.js 20 or later, macOS or Linux, and at least one host CLI — Claude Code, Codex 0.133.0 or later, or OpenCode.
|
|
27
|
+
|
|
28
|
+
Run it without a global install:
|
|
19
29
|
|
|
20
30
|
```bash
|
|
21
31
|
npx @ccoalm/ccl-skills@latest install
|
|
22
32
|
```
|
|
23
33
|
|
|
24
|
-
|
|
34
|
+
## What you get
|
|
35
|
+
|
|
36
|
+
| Stage | Covered by the skills |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| Requirements | intent and acceptance points, current-state baseline, change scope and slicing, PRD writing |
|
|
39
|
+
| Design | layout, interaction, states, accessibility, design-system consistency |
|
|
40
|
+
| Architecture | Go and Python service boundaries, RPC and API contracts, data ownership, reliability invariants |
|
|
41
|
+
| Implementation | Go, Python, React web, mini-programs, Flutter/React Native/iOS/Android, terminal and TUI, LLM integration |
|
|
42
|
+
| Testing | test layers, fixtures, mocks, regression coverage, CI gates, test-case documents, defect diagnosis |
|
|
43
|
+
| Review | independent CLI review, adversarial challenge, risk and gate routing, multi-perspective research |
|
|
44
|
+
| Release | rollout, canary, rollback, environment lanes, release scope and docs |
|
|
45
|
+
| Operations | logs, metrics, tracing, dashboards, alerts, SLO, service connectivity |
|
|
46
|
+
| Cross-stage | worktree isolation, multi-agent delegation, doc tightening, lesson extraction |
|
|
47
|
+
|
|
48
|
+
[Browse the full catalog](https://github.com/ccoalm/ccl-skills/blob/main/docs/SKILLS.md) for what each skill does and when to use another one instead. [Architecture](https://github.com/ccoalm/ccl-skills/blob/main/docs/ARCHITECTURE.md) explains how skills are selected, loaded, and checked; [Theory](https://github.com/ccoalm/ccl-skills/blob/main/docs/skills-theory-foundations.md) explains why the rules read the way they do.
|
|
49
|
+
|
|
50
|
+
This page ships inside the published tarball, so it only changes when a new version is released. The links above always show the current state.
|
|
51
|
+
|
|
52
|
+
## Commands
|
|
25
53
|
|
|
26
54
|
```bash
|
|
27
|
-
ccl-skills install
|
|
28
|
-
ccl-skills doctor
|
|
29
|
-
ccl-skills update
|
|
30
|
-
ccl-skills update --yes
|
|
31
|
-
ccl-skills uninstall
|
|
32
|
-
ccl-skills uninstall --yes
|
|
55
|
+
ccl-skills install # write host assets
|
|
56
|
+
ccl-skills doctor # report install state and drift from the manifest
|
|
57
|
+
ccl-skills update # preview
|
|
58
|
+
ccl-skills update --yes # upgrade the package, then refresh host assets
|
|
59
|
+
ccl-skills uninstall # preview
|
|
60
|
+
ccl-skills uninstall --yes # remove host assets
|
|
33
61
|
```
|
|
34
62
|
|
|
35
|
-
|
|
63
|
+
Limit any operation to one host with `--host claude`, `--host codex`, or `--host opencode`. Add `--json` for machine-readable output.
|
|
64
|
+
|
|
65
|
+
`update` and `uninstall` are previews unless `--yes` is supplied. `update --yes` first upgrades the global npm package to `@latest`, then asks the freshly installed CLI to refresh host assets. Set `CCL_SKILLS_SKIP_SELF_UPDATE=1` for an assets-only refresh; `--allow-downgrade` always uses the currently invoked package without installing `@latest` first.
|
|
36
66
|
|
|
37
67
|
After `ccl-skills uninstall --yes`, remove the CLI package itself with `npm uninstall --global @ccoalm/ccl-skills` if it is no longer needed.
|
|
38
68
|
|
|
@@ -48,7 +78,15 @@ Silence: CCL_SKILLS_NO_UPDATE_NOTIFIER=1
|
|
|
48
78
|
|
|
49
79
|
The registry check runs at most once every 24 hours in a detached background process, so no invocation waits for the network, and its result is shown by the next run. The notice and its check are both silent under `--json`, in CI, when stdout or stderr is not a terminal, in terminals narrower than 60 columns, and when `CCL_SKILLS_NO_UPDATE_NOTIFIER` or `NO_UPDATE_NOTIFIER` is set. State lives in `version-check.json` under the managed root; a failed check keeps the last known version and never blocks or fails the command.
|
|
50
80
|
|
|
51
|
-
|
|
81
|
+
## What lands where
|
|
82
|
+
|
|
83
|
+
| Host | What the installer writes |
|
|
84
|
+
| --- | --- |
|
|
85
|
+
| Claude Code | A package-owned local marketplace snapshot; the plugin hooks are consumed directly. |
|
|
86
|
+
| Codex | The same package-owned local marketplace snapshot. |
|
|
87
|
+
| OpenCode | Skills, a native event plugin, and `ccl-skills/runtime` under shared host directories. The adapter maps the shipped session, tool, prompt, subagent, and stop behaviors to OpenCode events and covers `edit`, `write`, and `apply_patch`. |
|
|
88
|
+
|
|
89
|
+
Installation refuses unknown collisions, and uninstall preserves shared files for manual cleanup instead of guessing ownership.
|
|
52
90
|
|
|
53
91
|
Set `CCL_SKILLS_REPO` to a valid checkout to override only the OpenCode asset source. An invalid override fails before writing host files. Without the variable, installation is offline after npm has downloaded the package.
|
|
54
92
|
|
|
@@ -59,3 +97,5 @@ npm ci
|
|
|
59
97
|
npm test
|
|
60
98
|
npm run test:pack
|
|
61
99
|
```
|
|
100
|
+
|
|
101
|
+
Issues and pull requests go to [ccoalm/ccl-skills](https://github.com/ccoalm/ccl-skills); see [CONTRIBUTING](https://github.com/ccoalm/ccl-skills/blob/main/docs/CONTRIBUTING.md).
|
package/dist/assets/release.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema": 1,
|
|
3
3
|
"npmPackage": "@ccoalm/ccl-skills",
|
|
4
|
-
"version": "0.6.
|
|
5
|
-
"sourceCommit": "
|
|
4
|
+
"version": "0.6.2",
|
|
5
|
+
"sourceCommit": "3caeb12e908e806a360d42aa4145f285195a6235",
|
|
6
6
|
"sourceState": "clean",
|
|
7
7
|
"files": [
|
|
8
8
|
{
|
|
@@ -3138,5 +3138,5 @@
|
|
|
3138
3138
|
"mode": 420
|
|
3139
3139
|
}
|
|
3140
3140
|
],
|
|
3141
|
-
"snapshotHash": "
|
|
3141
|
+
"snapshotHash": "595e85e2c775a6b55cc3da0bb600be7ca2e24acf5684ef40ecf4f2d2d53e1a7b"
|
|
3142
3142
|
}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ccoalm/ccl-skills",
|
|
3
|
-
"version": "0.6.
|
|
4
|
-
"description": "
|
|
5
|
-
"keywords": ["agent-skills", "claude-code", "codex", "opencode", "developer-tools"],
|
|
3
|
+
"version": "0.6.2",
|
|
4
|
+
"description": "Reusable workflows that help coding agents plan, build, test, review, and release software — for Claude Code, Codex, and OpenCode",
|
|
5
|
+
"keywords": ["skills", "agent-skills", "claude", "claude-code", "codex", "opencode", "agent", "ai", "ai-agents", "cli", "anthropic", "developer-tools"],
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": { "ccl-skills": "dist/cli.js" },
|
|
8
8
|
"exports": { ".": "./dist/index.js", "./package.json": "./package.json" },
|