@trendai-crem/claude-skills 1.0.0 → 1.0.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.
- package/README.md +139 -35
- package/package.json +1 -1
- package/sources.json +0 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @trendai-crem/claude-skills
|
|
2
2
|
|
|
3
|
-
One-command Claude Code skill installer for the team. Installs curated AI agent skills in a single line.
|
|
3
|
+
One-command Claude Code skill installer for the team. Installs curated AI agent skills and plugins in a single line.
|
|
4
4
|
|
|
5
5
|
## Quick Start
|
|
6
6
|
|
|
@@ -8,53 +8,50 @@ One-command Claude Code skill installer for the team. Installs curated AI agent
|
|
|
8
8
|
npx @trendai-crem/claude-skills
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
That's it. The command installs
|
|
11
|
+
That's it. The command installs all three source types declared in `sources.json`:
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
| Source type | What it installs | How to change |
|
|
14
|
+
|-------------|-----------------|---------------|
|
|
15
|
+
| **skills-repo** | [superpowers](https://github.com/obra/superpowers) — brainstorming, debugging, TDD, and more | Edit `sources.json`, bump version, PR |
|
|
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 |
|
|
15
18
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
Re-run the same command to get the latest version. If an update is available, you'll be notified automatically.
|
|
19
|
+
Re-run to update everything:
|
|
19
20
|
|
|
20
21
|
```bash
|
|
21
22
|
npx @trendai-crem/claude-skills@latest
|
|
22
23
|
```
|
|
23
24
|
|
|
24
|
-
|
|
25
|
+
Auto-update runs at session start — you'll be notified when a new version is available and it installs automatically.
|
|
25
26
|
|
|
26
|
-
|
|
27
|
+
## Team Skills (`skills/`)
|
|
27
28
|
|
|
28
29
|
| Skill | Trigger | Description |
|
|
29
30
|
|-------|---------|-------------|
|
|
30
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 |
|
|
31
33
|
| **reviewing-prs** | "review this PR", "review pull request" | Structured PR review with 3 independent sub-agents covering correctness, security, and requirements |
|
|
32
34
|
|
|
33
|
-
|
|
35
|
+
## Marketplace Plugins
|
|
34
36
|
|
|
35
|
-
|
|
36
|
-
|-------|---------|-------------|
|
|
37
|
-
| **atlassian-tools** | Any Confluence/Jira URL or mention | Confluence wiki and Jira issue management — create, update, search pages and tickets |
|
|
38
|
-
| **wiki-generation** | "create a wiki page", "generate Confluence docs" | Generate Confluence documentation with proper ADF format and Mermaid diagram support |
|
|
37
|
+
Installed from [ai-skill-marketplace](https://github.com/trend-ai-taskforce/ai-skill-marketplace) and `claude-plugins-official`. Configure in `sources.json`.
|
|
39
38
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
|
43
|
-
|
|
44
|
-
| **
|
|
45
|
-
| **
|
|
46
|
-
| **
|
|
47
|
-
| **
|
|
48
|
-
| **
|
|
49
|
-
| **shell** | "shell style", "bash coding standards" | Google Shell Style Guide reference |
|
|
50
|
-
| **cpp** | "c++ style", "cpp coding standards" | Google C++ Style Guide reference |
|
|
39
|
+
| Plugin | Marketplace | Description |
|
|
40
|
+
|--------|-------------|-------------|
|
|
41
|
+
| **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
|
+
| **google-style-guides** | ai-skill-marketplace | Google Style Guide references (Java, Python, Go, TypeScript, and more) |
|
|
44
|
+
| **l2-automation** | ai-skill-marketplace | L2 test automation and Robot Framework skills |
|
|
45
|
+
| **service-doc-generator** | ai-skill-marketplace | Systematic service documentation generation |
|
|
46
|
+
| **claude-on-teams** | ai-skill-marketplace | Claude integration for Microsoft Teams |
|
|
47
|
+
| **ralph-loop** | claude-plugins-official | Ralph Loop autonomous agent plugin |
|
|
51
48
|
|
|
52
49
|
## For Maintainers
|
|
53
50
|
|
|
54
51
|
### Adding a team skill
|
|
55
52
|
|
|
56
53
|
1. Create a branch: `git checkout -b feat/add-<skill-name>`
|
|
57
|
-
2. Add `skills/<skill-name>/SKILL.md
|
|
54
|
+
2. Add `skills/<skill-name>/SKILL.md`:
|
|
58
55
|
```markdown
|
|
59
56
|
---
|
|
60
57
|
name: skill-name
|
|
@@ -63,25 +60,132 @@ npx @trendai-crem/claude-skills@latest
|
|
|
63
60
|
|
|
64
61
|
# Skill content here
|
|
65
62
|
```
|
|
66
|
-
3. Commit, push,
|
|
67
|
-
4. Bump version
|
|
68
|
-
5.
|
|
63
|
+
3. Commit, push, open a PR — version bump is required (CI enforces this)
|
|
64
|
+
4. Bump version: `npm version minor`
|
|
65
|
+
5. Merge to `main` — CI publishes automatically
|
|
66
|
+
|
|
67
|
+
### Adding a marketplace plugin
|
|
68
|
+
|
|
69
|
+
Edit `sources.json` and add the plugin name to the appropriate marketplace entry:
|
|
70
|
+
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"type": "marketplace",
|
|
74
|
+
"name": "ai-skill-marketplace",
|
|
75
|
+
"source": "git@github.com:trend-ai-taskforce/ai-skill-marketplace.git",
|
|
76
|
+
"plugins": [
|
|
77
|
+
"existing-plugin",
|
|
78
|
+
"new-plugin-name"
|
|
79
|
+
]
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Bump version, PR, merge. All team members get the new plugin on their next session start.
|
|
84
|
+
|
|
85
|
+
### Adding an external skill source
|
|
86
|
+
|
|
87
|
+
Add a new `skills-repo` entry to `sources.json`:
|
|
88
|
+
|
|
89
|
+
```json
|
|
90
|
+
{
|
|
91
|
+
"type": "skills-repo",
|
|
92
|
+
"repo": "org/repo-name",
|
|
93
|
+
"flags": ["--all"],
|
|
94
|
+
"label": "repo-label"
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Bump version, PR, merge. Removal works the same way — deleting the entry propagates uninstall on next auto-update.
|
|
99
|
+
|
|
100
|
+
### Adding a new marketplace
|
|
101
|
+
|
|
102
|
+
Add a new `marketplace` entry to `sources.json`:
|
|
103
|
+
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"type": "marketplace",
|
|
107
|
+
"name": "another-marketplace",
|
|
108
|
+
"source": "anthropics/claude-plugins-official",
|
|
109
|
+
"plugins": ["plugin-name"]
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
The source can be a GitHub shorthand (`org/repo`) or a full git URL.
|
|
114
|
+
|
|
115
|
+
### Removing a team skill
|
|
116
|
+
|
|
117
|
+
1. Delete the `skills/<skill-name>/` directory
|
|
118
|
+
2. Bump version, open a PR, merge
|
|
119
|
+
3. All team members have the skill removed on their next session start (auto-update reconciles the manifest)
|
|
120
|
+
|
|
121
|
+
### Removing a marketplace plugin
|
|
122
|
+
|
|
123
|
+
Remove the plugin name from `sources.json`:
|
|
124
|
+
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"type": "marketplace",
|
|
128
|
+
"name": "ai-skill-marketplace",
|
|
129
|
+
"plugins": [
|
|
130
|
+
"wiki-tools"
|
|
131
|
+
// remove "atlassian-tools" by deleting that line
|
|
132
|
+
]
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Bump version, PR, merge. The plugin is uninstalled for all team members on next auto-update.
|
|
137
|
+
|
|
138
|
+
### Removing an entire marketplace or skill source
|
|
139
|
+
|
|
140
|
+
Delete the entire entry from `sources.json`:
|
|
141
|
+
|
|
142
|
+
```json
|
|
143
|
+
{
|
|
144
|
+
"sources": [
|
|
145
|
+
// remove the entire { "type": "marketplace", "name": "..." } block
|
|
146
|
+
]
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
All plugins/skills from that source are uninstalled for all team members on next auto-update.
|
|
151
|
+
|
|
152
|
+
> **How removal propagation works:** The installer tracks what it manages in `~/.claude/claude-skills-manifest.json`. When an entry is missing from `sources.json`, the next run detects the discrepancy and uninstalls the affected items before writing the updated manifest.
|
|
69
153
|
|
|
70
154
|
### Version bumping
|
|
71
155
|
|
|
156
|
+
A version bump is required whenever any of these change: `cli.js`, `lib/`, `sources.json`, `skills/`, `package.json`. CI will fail the PR if you forget.
|
|
157
|
+
|
|
72
158
|
```bash
|
|
73
|
-
npm version patch # bug fixes /
|
|
74
|
-
npm version minor # new skills added
|
|
75
|
-
npm version major # breaking changes
|
|
159
|
+
npm version patch # bug fixes / content updates
|
|
160
|
+
npm version minor # new skills or plugins added
|
|
161
|
+
npm version major # breaking changes (e.g. manifest format)
|
|
76
162
|
```
|
|
77
163
|
|
|
78
|
-
|
|
164
|
+
### Uninstalling
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
bash uninstall.sh # remove everything
|
|
168
|
+
bash uninstall.sh --dry # preview what would be removed
|
|
169
|
+
```
|
|
79
170
|
|
|
80
|
-
|
|
171
|
+
## Architecture
|
|
172
|
+
|
|
173
|
+
All sources are declared in `sources.json`. Adding any source type requires only a config change — no code changes needed.
|
|
174
|
+
|
|
175
|
+
```
|
|
176
|
+
sources.json
|
|
177
|
+
↓
|
|
178
|
+
cli.js (thin orchestrator)
|
|
179
|
+
↓
|
|
180
|
+
lib/handlers/{skills-dir, skills-repo, marketplace}.js
|
|
181
|
+
↓
|
|
182
|
+
~/.claude/claude-skills-manifest.json (tracks what's installed)
|
|
183
|
+
```
|
|
81
184
|
|
|
82
|
-
|
|
185
|
+
Removals propagate automatically: remove an entry from `sources.json`, bump version, and the next auto-update uninstalls it for all team members.
|
|
83
186
|
|
|
84
187
|
## Requirements
|
|
85
188
|
|
|
86
189
|
- Node.js >= 20
|
|
87
190
|
- npm / npx
|
|
191
|
+
- Claude Code CLI
|
package/package.json
CHANGED