@drunkcoding/agents-and-skills 0.0.27 → 0.0.28

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 (7) hide show
  1. package/.claude-plugin/marketplace.json +4 -4
  2. package/package.json +1 -1
  3. package/plugins/html-effectiveness/.claude-plugin/plugin.json +1 -1
  4. package/plugins/plugin-validator/.claude-plugin/plugin.json +1 -1
  5. package/plugins/team-share/.claude-plugin/plugin.json +1 -1
  6. package/plugins/team-share/agents/team-share.md +35 -13
  7. package/plugins/tech-graph/.claude-plugin/plugin.json +1 -1
package/.claude-plugin/marketplace.json CHANGED
@@ -12,7 +12,7 @@
12
12
  "name": "tech-graph",
13
13
  "source": "./plugins/tech-graph",
14
14
  "description": "6-step wizard for technical diagrams (SVG/PNG) via fireworks-tech-graph",
15
- "version": "0.0.27",
15
+ "version": "0.0.28",
16
16
  "category": "diagram",
17
17
  "keywords": [
18
18
  "diagram",
@@ -26,7 +26,7 @@
26
26
  "name": "html-effectiveness",
27
27
  "source": "./plugins/html-effectiveness",
28
28
  "description": "Generate self-contained interactive HTML reports from 20 upstream templates via a conversational agent.",
29
- "version": "0.0.27",
29
+ "version": "0.0.28",
30
30
  "category": "reports",
31
31
  "keywords": [
32
32
  "html",
@@ -41,7 +41,7 @@
41
41
  "name": "plugin-validator",
42
42
  "source": "./plugins/plugin-validator",
43
43
  "description": "Orchestrated validator for Claude Code plugins — validates skills, agents, commands, and hooks across every plugin under plugins/**.",
44
- "version": "0.0.27",
44
+ "version": "0.0.28",
45
45
  "category": "tooling",
46
46
  "keywords": [
47
47
  "validation",
@@ -57,7 +57,7 @@
57
57
  "name": "team-share",
58
58
  "source": "./plugins/team-share",
59
59
  "description": "Share Claude plugin settings with a team, scaffold CLAUDE.md when needed, refresh the Understand-Anything graph, and stage the onboarding artifacts for review.",
60
- "version": "0.0.27",
60
+ "version": "0.0.28",
61
61
  "category": "tooling",
62
62
  "keywords": [
63
63
  "onboarding",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@drunkcoding/agents-and-skills",
3
- "version": "0.0.27",
3
+ "version": "0.0.28",
4
4
  "description": "Personal collection of Claude Code skills and agents, installable via `npx skills`.",
5
5
  "keywords": [
6
6
  "claude-code",
package/plugins/html-effectiveness/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "html-effectiveness",
3
3
  "displayName": "HTML Effectiveness Reports",
4
- "version": "0.0.27",
4
+ "version": "0.0.28",
5
5
  "description": "Generate self-contained interactive HTML reports from 20 upstream templates via a conversational agent.",
6
6
  "author": {
7
7
  "name": "Steven Hoang"
package/plugins/plugin-validator/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "plugin-validator",
3
3
  "displayName": "Plugin Validator",
4
- "version": "0.0.27",
4
+ "version": "0.0.28",
5
5
  "description": "Orchestrated validator for Claude Code plugins — validates skills, agents, commands, and hooks across every plugin under plugins/**.",
6
6
  "author": {
7
7
  "name": "Steven Hoang"
package/plugins/team-share/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "team-share",
3
3
  "displayName": "Team Share",
4
- "version": "0.0.27",
4
+ "version": "0.0.28",
5
5
  "description": "Share Claude plugin settings with a team, scaffold CLAUDE.md when needed, refresh the Understand-Anything graph, and stage the onboarding artifacts for review.",
6
6
  "author": {
7
7
  "name": "Steven Hoang"
package/plugins/team-share/agents/team-share.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: team-share
3
- description: Share Claude plugin settings with the team, build or refresh the Understand-Anything knowledge graph with auto-update, and git-lfs track it before staging everything for review.
3
+ description: Share Claude plugin settings with the team, build or refresh the Understand-Anything knowledge graph, initialize the docs wiki, and git-lfs track it before staging everything for review.
4
4
  argument-hint: "[--force] [--language <lang>] (passed through to /understand)"
5
5
  allowed-tools: Bash, Read, Write, Edit, Glob, Grep, Skill
6
6
  ---
@@ -11,7 +11,8 @@ Make this repo onboarding-ready for the team in one pass:
11
11
 
12
12
  1. Generate a **shareable `.claude/settings.json`** (plugins + marketplaces) from the maintainer's live setup.
13
13
  2. Build/refresh the **Understand-Anything knowledge graph** with auto-update enabled.
14
- 3. **git-lfs track** the graph and **stage** everything — leaving the commit to a human.
14
+ 3. Initialize the **docs wiki** for Understand-Anything under `docs/wiki`.
15
+ 4. **git-lfs track** the graph and **stage** everything — leaving the commit to a human.
15
16
 
16
17
  This command is **idempotent** — safe to re-run. It **never commits or pushes**; it only stages.
17
18
  `$ARGUMENTS` (e.g. `--force`, `--language zh`) is forwarded to `/understand`.
@@ -40,7 +41,7 @@ Goal: teammates who clone the repo get the **same plugins + marketplaces** the m
40
41
 
41
42
  ### 1a — Merge plugin + marketplace settings
42
43
 
43
- Copy **only** `enabledPlugins` and `extraKnownMarketplaces` from the maintainer's user settings into the repo settings. Do **NOT** copy `hooks`, `permissions`, `env`, or any key holding absolute paths or local tooling (those are per-machine and may expose private paths).
44
+ Copy **only** `enabledPlugins` and `extraKnownMarketplaces` from the maintainer's user settings into the repo settings. Do **NOT** copy `hooks`, `permissions`, `env`, or any key holding absolute paths or machine-local secrets.
44
45
 
45
46
  ```bash
46
47
  USER_SETTINGS="$HOME/.claude/settings.json"
@@ -70,7 +71,7 @@ Notes:
70
71
 
71
72
  ### 1b — Scaffold `CLAUDE.md` if missing
72
73
 
73
- The `claude-code-setup` plugin (from the `claude-plugins-official` marketplace) generates a project-savvy `CLAUDE.md` when one does not yet exist. Running the install command is **idempotent** — if `CLAUDE.md` is already present it will **not** be overwritten.
74
+ The `claude-code-setup` plugin (from the `claude-plugins-official` marketplace) generates a project-savvy `CLAUDE.md` when one does not yet exist. Running the install command is **idempotent** — if the file already exists, this step is skipped.
74
75
 
75
76
  ```bash
76
77
  # Only create CLAUDE.md when it does not already exist.
@@ -104,7 +105,7 @@ else
104
105
 
105
106
  ## Code research with Understand-Anything
106
107
 
107
- This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw grep/glob when researching code structure, relationships, or logic:**
108
+ This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw file-by-file exploration when doing code research:**
108
109
 
109
110
  | Goal | Command |
110
111
  |------|---------|
@@ -115,8 +116,9 @@ This project uses the [Understand-Anything](https://github.com/Egonex-AI/Underst
115
116
  | Open the interactive visual dashboard | `/understand-dashboard` |
116
117
  | Extract business-domain knowledge (domains, flows, steps) | `/understand-domain` |
117
118
  | Generate an onboarding guide for new teammates | `/understand-onboard` |
119
+ | Generate or refresh wiki knowledge under `docs/wiki` | `/understand-knowledge docs/wiki` |
118
120
 
119
- The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force a full rebuild, or pass `--force` to rebuild from scratch.
121
+ The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force the graph to catch up, and re-run `/understand-knowledge docs/wiki` when you want to refresh the generated wiki content.
120
122
  EOF
121
123
  echo "✅ Understand-Anything code-research section appended to CLAUDE.md."
122
124
  fi
@@ -125,7 +127,7 @@ fi
125
127
  Notes:
126
128
  - The section is appended at the end of `CLAUDE.md` so it does not disturb existing content.
127
129
  - The marker string `## Code research with Understand-Anything` is used as the idempotency guard — do not rename the heading without updating the guard.
128
- - If `MIRRORS.md` / `AGENTS.md` or other agent-config files exist alongside `CLAUDE.md` (e.g. for non-Claude runtimes), apply the same append to them so all agent runtimes get the guidance. The loop below covers `AGENTS.md` and `MIRRORS.md` — add more filenames to the `for` list if the project uses additional agent-config files.
130
+ - If `MIRRORS.md` / `AGENTS.md` or other agent-config files exist alongside `CLAUDE.md` (e.g. for non-Claude runtimes), apply the same append to them so all agent runtimes get the guidance. The loop below appends the same section only when missing.
129
131
 
130
132
  ```bash
131
133
  # Mirror to AGENTS.md / MIRRORS.md if they exist (non-Claude runtimes).
@@ -135,7 +137,7 @@ for f in AGENTS.md MIRRORS.md; do
135
137
 
136
138
  ## Code research with Understand-Anything
137
139
 
138
- This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw grep/glob when researching code structure, relationships, or logic:**
140
+ This project uses the [Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) plugin to maintain an interactive knowledge graph of the codebase. **Always prefer these commands over raw file-by-file exploration when doing code research:**
139
141
 
140
142
  | Goal | Command |
141
143
  |------|---------|
@@ -146,8 +148,9 @@ This project uses the [Understand-Anything](https://github.com/Egonex-AI/Underst
146
148
  | Open the interactive visual dashboard | `/understand-dashboard` |
147
149
  | Extract business-domain knowledge (domains, flows, steps) | `/understand-domain` |
148
150
  | Generate an onboarding guide for new teammates | `/understand-onboard` |
151
+ | Generate or refresh wiki knowledge under `docs/wiki` | `/understand-knowledge docs/wiki` |
149
152
 
150
- The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force a full rebuild, or pass `--force` to rebuild from scratch.
153
+ The knowledge graph lives in `.understand-anything/knowledge-graph.json` and is kept up-to-date automatically on every commit (auto-update is enabled). Re-run `/understand` after large refactors to force the graph to catch up, and re-run `/understand-knowledge docs/wiki` when you want to refresh the generated wiki content.
151
154
  EOF
152
155
  echo "✅ Understand-Anything section also appended to $f."
153
156
  fi
@@ -164,13 +167,31 @@ Run the skill **in the main thread** (it dispatches its own analyzer subagents
164
167
  /understand --auto-update $ARGUMENTS
165
168
  ```
166
169
 
167
- - `--auto-update` writes `{"autoUpdate": true}` to `.understand-anything/config.json`. The plugin's bundled hook then incrementally patches the graph whenever a `git commit` is made (and on stale SessionStart), so each commit lands with a matching graph.
170
+ - `--auto-update` writes `{"autoUpdate": true}` to `.understand-anything/config.json`. The plugin's bundled hook then incrementally patches the graph whenever a `git commit` is made (and on stale Session resume, depending on the plugin version).
168
171
  - If a graph already exists, `/understand` runs incrementally. Pass `--force` (via `$ARGUMENTS`) to rebuild from scratch.
169
172
  - After it finishes, confirm these exist: `.understand-anything/knowledge-graph.json`, `.understand-anything/meta.json`, `.understand-anything/config.json` (with `autoUpdate: true`).
170
173
 
171
174
  ---
172
175
 
173
- ## Step 3 — Ignore scratch, git-lfs track the graph, and stage
176
+ ## Step 3 — Initialize the docs wiki from Understand-Anything
177
+
178
+ Create the wiki folder if needed, then generate or refresh the wiki content in the main thread:
179
+
180
+ ```bash
181
+ mkdir -p docs/wiki
182
+ ```
183
+
184
+ ```
185
+ /understand-knowledge docs/wiki
186
+ ```
187
+
188
+ - `mkdir -p docs/wiki` is idempotent and ensures the target directory exists before wiki generation.
189
+ - Re-running `/understand-knowledge docs/wiki` should refresh the generated wiki content in place.
190
+ - After it finishes, confirm `docs/wiki/` exists and contains generated wiki files before staging.
191
+
192
+ ---
193
+
194
+ ## Step 4 — Ignore scratch, git-lfs track the graph, and stage
174
195
 
175
196
  Scratch outputs must stay local (never committed):
176
197
 
@@ -185,7 +206,7 @@ git lfs install
185
206
  git lfs track ".understand-anything/*.json"
186
207
 
187
208
  # Stage — but DO NOT commit. A human reviews and commits.
188
- git add .gitattributes .gitignore .claude/settings.json .understand-anything/ CLAUDE.md
209
+ git add .gitattributes .gitignore .claude/settings.json .understand-anything/ docs/wiki/ CLAUDE.md
189
210
  # Also stage AGENTS.md / MIRRORS.md if they were modified.
190
211
  for f in AGENTS.md MIRRORS.md; do [ -f "$f" ] && git add "$f"; done
191
212
 
@@ -202,5 +223,6 @@ Summarize for the user:
202
223
  - `CLAUDE.md` status: already existed vs created by `claude-code-setup`; Understand-Anything section added vs already present.
203
224
  - `AGENTS.md` status (if applicable): Understand-Anything section added vs already present / not found.
204
225
  - Graph status: created vs incrementally updated; `autoUpdate` on/off.
226
+ - Wiki status: `docs/wiki` created vs already existed; `/understand-knowledge docs/wiki` run successfully vs failed.
205
227
  - What is staged and confirmed LFS-tracked.
206
- - Remind them: **review, then commit yourself** (e.g. `git commit -m "chore: share team onboarding (claude settings + CLAUDE.md + understand graph)"`). The auto-update hook keeps the graph fresh on every future commit.
228
+ - Remind them: **review, then commit yourself** (e.g. `git commit -m "chore: share team onboarding (claude settings + CLAUDE.md + understand graph + wiki)"`). The auto-update hook keeps the graph fresh on every future commit, and the wiki can be refreshed by re-running `/understand-knowledge docs/wiki` whenever needed.
package/plugins/tech-graph/.claude-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tech-graph",
3
- "version": "0.0.27",
3
+ "version": "0.0.28",
4
4
  "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
5
5
  "author": {
6
6
  "name": "steven"