@trendai-crem/claude-skills 1.1.0 → 1.1.1

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.
Files changed (3) hide show
  1. package/README.md +47 -5
  2. package/cli.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -14,7 +14,7 @@ That's it. The command installs all three source types declared in `sources.json
14
14
  |-------------|-----------------|---------------|
15
15
  | **skills-repo** | [superpowers](https://github.com/obra/superpowers) — brainstorming, debugging, TDD, and more | Edit `sources.json`, bump version, PR |
16
16
  | **skills-dir** | Team skills in this repo's `skills/` directory | Add/remove `skills/<name>/`, bump version, PR |
17
- | **marketplace** | Plugins from `ai-skill-marketplace` and `claude-plugins-official` | Edit `plugins` list in `sources.json`, bump version, PR |
17
+ | **marketplace** | Plugins from `ai-skill-marketplace`, `claude-plugins-official`, and `openai-codex` | Edit `plugins` list in `sources.json`, bump version, PR |
18
18
 
19
19
  Re-run to update everything:
20
20
 
@@ -29,22 +29,20 @@ Auto-update runs at session start — you'll be notified when a new version is a
29
29
  | Skill | Trigger | Description |
30
30
  |-------|---------|-------------|
31
31
  | **code-review** | "review my code", "code review" | Multi-perspective review — 5 reviewers + Codex baseline, enforces TM RDSec policy and Secure Coding Dojo checkpoints |
32
- | **codex** | "use codex", "ask codex to..." | Delegate coding tasks to Codex CLI |
33
32
  | **reviewing-prs** | "review this PR", "review pull request" | Structured PR review with 3 independent sub-agents covering correctness, security, and requirements |
34
33
 
35
34
  ## Marketplace Plugins
36
35
 
37
- Installed from [ai-skill-marketplace](https://github.com/trend-ai-taskforce/ai-skill-marketplace) and `claude-plugins-official`. Configure in `sources.json`.
36
+ Installed from [ai-skill-marketplace](https://github.com/trend-ai-taskforce/ai-skill-marketplace), `claude-plugins-official`, and `openai-codex`. Configure in `sources.json`.
38
37
 
39
38
  | Plugin | Marketplace | Description |
40
39
  |--------|-------------|-------------|
41
40
  | **atlassian-tools** | ai-skill-marketplace | Confluence wiki and Jira issue management |
42
- | **wiki-tools** | ai-skill-marketplace | Confluence documentation with ADF format and Mermaid support |
43
41
  | **google-style-guides** | ai-skill-marketplace | Google Style Guide references (Java, Python, Go, TypeScript, and more) |
44
42
  | **l2-automation** | ai-skill-marketplace | L2 test automation and Robot Framework skills |
45
43
  | **service-doc-generator** | ai-skill-marketplace | Systematic service documentation generation |
46
- | **claude-on-teams** | ai-skill-marketplace | Claude integration for Microsoft Teams |
47
44
  | **ralph-loop** | claude-plugins-official | Ralph Loop autonomous agent plugin |
45
+ | **codex** | openai-codex | Official OpenAI Codex plugin — CLI runtime, review commands, rescue agent, GPT prompting guides |
48
46
 
49
47
  ## For Maintainers
50
48
 
@@ -184,6 +182,50 @@ lib/handlers/{skills-dir, skills-repo, marketplace}.js
184
182
 
185
183
  Removals propagate automatically: remove an entry from `sources.json`, bump version, and the next auto-update uninstalls it for all team members.
186
184
 
185
+ ### Auto-Update Mechanism
186
+
187
+ When `cli.js` runs, it registers two shell hook scripts into `~/.claude/settings.json` after installation:
188
+
189
+ ```
190
+ cli.js ── setupAutoUpdate()
191
+
192
+ ├─► ~/.claude/hooks/claude-skills-install-update.sh
193
+ │ Hook type: SessionStart
194
+ │ Throttle: 24 hours
195
+ │ Action: npm install + run cli.js silently
196
+ │ Output: systemMessage "claude-skills updated: X → Y"
197
+
198
+ └─► ~/.claude/hooks/auto-update-claude-skills.sh
199
+ Hook type: UserPromptSubmit
200
+ Throttle: 2 hours
201
+ Action: npm view (version check only, no install)
202
+ Output: systemMessage "update available: X → Y"
203
+ ```
204
+
205
+ **How it works:**
206
+
207
+ 1. **SessionStart hook** — runs once per 24 hours at session startup. Compares the installed version against npm registry. If a newer version exists, downloads and runs it in a temp directory. The new `cli.js` re-installs all sources from the updated `sources.json`, effectively propagating any added/removed skills or plugins. Emits a `systemMessage` to notify the user.
208
+
209
+ 2. **UserPromptSubmit hook** — runs once per 2 hours when the user submits a prompt. Only checks for a newer version on npm (no install). If found, emits a `systemMessage` with the update command.
210
+
211
+ 3. **Throttle files** — stored in `~/.cache/claude-skills-install-check.json` and `~/.cache/claude-skills-version-check.json`. Each contains a `ts` field (Unix epoch) to prevent redundant checks within the throttle window.
212
+
213
+ 4. **Version pinning** — both scripts are generated with the currently installed version baked in as a constant. When a new version is installed, the scripts are regenerated with the new version, resetting the baseline for future comparisons.
214
+
215
+ **Propagation flow (maintainer publishes → team member receives):**
216
+
217
+ ```
218
+ Maintainer: edit sources.json → bump version → merge PR → CI publishes to npm
219
+
220
+ Team member: starts Claude Code session
221
+
222
+ SessionStart hook fires → detects new version on npm → installs in temp dir
223
+
224
+ New cli.js runs → reads updated sources.json → installs/uninstalls diff
225
+
226
+ Manifest updated → hooks regenerated with new version → done
227
+ ```
228
+
187
229
  ## Requirements
188
230
 
189
231
  - Node.js >= 20
package/cli.js CHANGED
@@ -170,7 +170,7 @@ LATEST=$(npm view "$PACKAGE" version 2>/dev/null || echo "")
170
170
 
171
171
  INSTALL_DIR="$(mktemp -d)"
172
172
  if npm install --prefix "$INSTALL_DIR" "$PACKAGE@$LATEST" --silent 2>/dev/null \\
173
- && node "$INSTALL_DIR/node_modules/$PACKAGE/cli.js" 2>/dev/null; then
173
+ && node "$INSTALL_DIR/node_modules/$PACKAGE/cli.js" >/dev/null 2>&1; then
174
174
  rm -rf "$INSTALL_DIR"
175
175
  python3 -c "import json,sys; print(json.dumps({'systemMessage': 'claude-skills updated: ' + sys.argv[1] + ' \u2192 ' + sys.argv[2]}))" "$INSTALLED" "$LATEST"
176
176
  else
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trendai-crem/claude-skills",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Claude Code skills installer for the trendai-crem team",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {