@drunkcoding/agents-and-skills 0.0.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,26 @@
+{
+  "name": "neptune",
+  "owner": {
+    "name": "steven",
+    "email": "steven.hoang@transwap.com"
+  },
+  "metadata": {
+    "description": "Personal agents and skills marketplace"
+  },
+  "plugins": [
+    {
+      "name": "tech-graph",
+      "source": "./plugins/tech-graph",
+      "description": "6-step wizard for technical diagrams (SVG/PNG) via fireworks-tech-graph",
+      "version": "0.0.1",
+      "category": "diagram",
+      "keywords": [
+        "diagram",
+        "svg",
+        "architecture",
+        "uml",
+        "flowchart"
+      ]
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steven Hoang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# agents-and-skills
+
+Personal [Claude Code](https://code.claude.com) plugin marketplace. Hosts agents, skills, and slash commands as installable plugins.
+
+Published on npm as [`@drunkcoding/agents-and-skills`](https://www.npmjs.com/package/@drunkcoding/agents-and-skills).
+
+## Plugins
+
+| Plugin | Description |
+|--------|-------------|
+| [`tech-graph`](plugins/tech-graph) | 6-step wizard for technical diagrams (SVG + PNG). |
+
+## Install
+
+### Claude Code marketplace
+
+```text
+/plugin marketplace add drunkcoding/agents-and-skills
+/plugin install <plugin-name>@neptune
+```
+
+Only the plugin you install loads; others stay dormant.
+
+### npm / npx
+
+```bash
+# Whole marketplace
+npm install -g @drunkcoding/agents-and-skills
+
+# Or via npx skills (https://github.com/vercel-labs/skills)
+npx skills add @drunkcoding/agents-and-skills
+```
+
+## Layout
+
+```
+.claude-plugin/marketplace.json       # marketplace manifest (Claude Code)
+plugins/<plugin>/                     # one folder per plugin
+  .claude-plugin/plugin.json          # plugin manifest
+  agents/   commands/   skills/       # plugin contents
+package.json                          # npm metadata
+```
+
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md).
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@drunkcoding/agents-and-skills",
+  "version": "0.0.1",
+  "description": "Personal collection of Claude Code skills and agents, installable via `npx skills`.",
+  "keywords": [
+    "claude-code",
+    "claude-skills",
+    "agent-skills",
+    "skills",
+    "gitnexus",
+    "npx-skills"
+  ],
+  "author": "Steven Hoang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drunkcoding/agents-and-skills.git"
+  },
+  "homepage": "https://github.com/drunkcoding/agents-and-skills#readme",
+  "bugs": {
+    "url": "https://github.com/drunkcoding/agents-and-skills/issues"
+  },
+  "files": [
+    "plugins/**",
+    ".claude-plugin/marketplace.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/plugins/tech-graph/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "tech-graph",
+  "version": "0.0.1",
+  "description": "Step-by-step wizard for generating technical diagrams as SVG+PNG.",
+  "author": {
+    "name": "steven"
+  },
+  "keywords": [
+    "diagram",
+    "svg",
+    "architecture",
+    "uml",
+    "flowchart",
+    "sequence",
+    "er"
+  ]
+}

package/plugins/tech-graph/README.md

@@ -0,0 +1,66 @@
+# tech-graph
+
+Step-by-step wizard for generating technical diagrams (architecture, flowchart, sequence, UML-class, ER, agent-loop, concept-map) as SVG + PNG. Delegates rendering to the upstream [`fireworks-tech-graph`](https://github.com/yizhiyanhua-ai/fireworks-tech-graph) skill (vendored here under `skills/tech-graph/`).
+
+## Install
+
+From inside Claude Code:
+
+```text
+/plugin marketplace add <user>/neptune
+/plugin install tech-graph@neptune
+```
+
+Then run `/tech-graph` (or `/tech-graph "auth flow"` to seed a topic).
+
+## Renderer Dependency
+
+The plugin needs ONE of these on your system (cairosvg recommended):
+
+| Renderer | Install |
+|----------|---------|
+| `cairosvg` | `pip install cairosvg` (Python ≥ 3.8) |
+| `rsvg-convert` | macOS: `brew install librsvg` / Debian: `apt-get install librsvg2-bin` |
+| `puppeteer` | `npm install -g puppeteer` (heavy; last resort) |
+
+Probe + auto-select:
+
+```bash
+bash plugins/tech-graph/scripts/check-deps.sh
+```
+
+The script writes the selected renderer name to `skills/tech-graph/.renderer` and skips re-probing on later runs.
+
+## Wizard Steps
+
+1. Purpose — exec-summary / engineering-review ★ / docs / blog / debug-thinking
+2. Type — architecture ★ / flowchart / sequence / UML-class / ER / agent-loop / concept-map
+3. Style — one of 7 (recommended ★ based on purpose × type)
+4. Format — SVG ★ / PNG / both
+5. Density — minimal / standard ★ / detailed
+6. Confirm — render or edit a previous step
+
+Mid-wizard you may say: `redo step 3`, `change style`, or `cancel`.
+
+## Output
+
+- Default outdir: `./diagrams/`
+- Filename: `<topic-slug>-<type>-<style>.svg` (collisions → `-2`, `-3`, …)
+
+## Optional — draw.io MCP
+
+This plugin does **not** bundle draw.io's MCP server. If you want it available alongside, add this to `~/.claude/settings.json` or your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "drawio": { "type": "http", "url": "https://mcp.draw.io/mcp" }
+  }
+}
+```
+
+The `tech-graph` subagent does **not** depend on this MCP — it is purely opt-in.
+
+## Upstream Sync
+
+See `../../CONTRIBUTING.md` at the repo root for the `git subtree pull` workflow.

package/plugins/tech-graph/agents/tech-graph.md

@@ -0,0 +1,89 @@
+---
+name: tech-graph
+description: Step-by-step wizard for generating technical diagrams (architecture, flowchart, sequence, UML, ER, agent-loop, concept-map) as SVG/PNG via the fireworks-tech-graph skill.
+tools: Read, Write, Edit, Bash, Glob, Grep
+model: sonnet
+---
+
+# Tech-Graph Wizard
+
+You are a diagram wizard. Walk the user through 6 steps **one at a time**, then render an SVG (and optionally PNG) by delegating to the upstream `fireworks-tech-graph` skill at `plugins/tech-graph/skills/tech-graph/`.
+
+## Hard Rules
+
+1. **One question per message.** Always multiple-choice. Mark the default with `★`.
+2. Never skip a step unless the user explicitly says "use defaults".
+3. Maintain wizard state in your working memory as JSON:
+   ```json
+   { "topic": "", "purpose": "", "type": "", "style": "", "format": "", "density": "", "filename": "", "outdir": "./diagrams" }
+   ```
+4. Defer reading the upstream `SKILL.md`, `references/`, `templates/` until step 6 (confirmation). At step 6, Read them, then author SVG content.
+5. **Fail fast on missing renderer.** Before authoring SVG, run `bash plugins/tech-graph/scripts/check-deps.sh`. If exit != 0, quote the script's stderr verbatim to the user and halt. Do not write any SVG.
+6. Never edit anything under `plugins/tech-graph/skills/tech-graph/` — that path is a git subtree and must stay verbatim.
+
+## The 6 Steps
+
+### Step 1 — Purpose / audience
+Ask: "What is this diagram for?"
+Options:
+- (a) exec-summary
+- (b) engineering-review ★
+- (c) docs
+- (d) blog
+- (e) debug-thinking
+
+### Step 2 — Diagram type
+Ask: "What type of diagram?"
+Options:
+- (a) architecture ★
+- (b) flowchart
+- (c) sequence
+- (d) UML-class
+- (e) ER
+- (f) agent-loop
+- (g) concept-map
+
+### Step 3 — Style
+Read `plugins/tech-graph/skills/tech-graph/references/` for the 7 upstream style references. Recommend one based on `(purpose, type)` and present all 7 with the recommendation marked `★`.
+
+### Step 4 — Format
+Ask: "Output format?"
+Options:
+- (a) SVG ★
+- (b) PNG
+- (c) both
+
+### Step 5 — Complexity / density
+Ask: "How dense should it be?"
+Options:
+- (a) minimal
+- (b) standard ★
+- (c) detailed
+
+### Step 6 — Confirm
+Show the user the full state summary, plus the resolved `filename` and `outdir`. Filename pattern: `<topic-slug>-<type>-<style>.svg`. If the file exists, append `-2`, `-3`, …
+Options: (a) yes — render, (b) edit step N, (c) cancel.
+
+## Render Protocol (after step 6 = yes)
+
+1. `bash plugins/tech-graph/scripts/check-deps.sh` — abort on failure (rule 5).
+2. Read upstream `SKILL.md` and the template files for the chosen `type`/`style`.
+3. Author the SVG content following the upstream style reference and density hint, then either:
+   - Write SVG directly to `<outdir>/<filename>`, OR
+   - Use `python3 plugins/tech-graph/skills/tech-graph/scripts/generate-from-template.py <type> <out.svg> '<json>'` when a template applies.
+4. Validate + export PNG (when format=PNG or both):
+   `bash plugins/tech-graph/skills/tech-graph/scripts/generate-diagram.sh -t <type> -s <style> -o <out.svg>`
+5. Report the absolute path of every file written. Suggest the user run `snip open <path>` for visual review.
+
+## Re-entry
+
+Accept these at any point:
+- "redo step N" — return to step N keeping all other state.
+- "change style" — return to step 3.
+- "cancel" — discard state and stop.
+
+## Failure Handling
+
+- Missing renderer → quote the `check-deps.sh` stderr verbatim, halt.
+- Upstream script non-zero exit → quote the script's stderr verbatim, halt; do not write a partial SVG.
+- Invalid SVG (validation failure) → quote validator output, halt, do not export PNG.

package/plugins/tech-graph/commands/tech-graph.md

@@ -0,0 +1,13 @@
+---
+description: Step-by-step wizard for generating technical diagrams (SVG/PNG).
+argument-hint: [optional one-line topic]
+---
+
+Dispatch the `tech-graph` subagent using the Agent tool. Pass `$ARGUMENTS` (which may be empty) as the initial topic seed in the subagent prompt.
+
+Subagent dispatch prompt template:
+
+> Run the tech-graph wizard. Initial topic seed: `$ARGUMENTS`.
+> Walk the user through all 6 steps even when a seed is provided. Use multiple-choice options with the marked default (★). Maintain wizard state as JSON in your working memory across turns. Do not skip steps unless the user explicitly says "use defaults".
+
+Do not perform any rendering or file generation in the main thread — the subagent owns the full wizard and the render call.

package/plugins/tech-graph/scripts/check-deps.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# check-deps.sh — probe SVG→PNG renderers for tech-graph plugin.
+# Probes in order: cairosvg (python) → rsvg-convert (system) → puppeteer (node).
+# Writes the first available choice to skills/tech-graph/.renderer.
+# Exits 0 on success, 1 if none found (prints exact install cmd).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+RENDERER_FILE="$PLUGIN_DIR/skills/tech-graph/.renderer"
+
+probe_cairosvg() {
+  python3 -c "import cairosvg" >/dev/null 2>&1
+}
+
+probe_rsvg() {
+  command -v rsvg-convert >/dev/null 2>&1
+}
+
+probe_puppeteer() {
+  node -e "require('puppeteer')" >/dev/null 2>&1
+}
+
+if probe_cairosvg; then
+  echo "cairosvg" > "$RENDERER_FILE"
+  echo "Renderer: cairosvg (python) — selected"
+  exit 0
+fi
+
+if probe_rsvg; then
+  echo "rsvg-convert" > "$RENDERER_FILE"
+  echo "Renderer: rsvg-convert — selected"
+  exit 0
+fi
+
+if probe_puppeteer; then
+  echo "puppeteer" > "$RENDERER_FILE"
+  echo "Renderer: puppeteer (node) — selected"
+  exit 0
+fi
+
+cat <<'EOF' >&2
+ERROR: No SVG→PNG renderer found on this system.
+
+Install ONE of the following (cairosvg is recommended):
+
+  1) pip install cairosvg            # requires Python >= 3.8
+  2) brew install librsvg            # macOS
+     apt-get install librsvg2-bin    # Debian/Ubuntu
+  3) npm install -g puppeteer        # heavy; last resort
+
+After install, re-run: bash plugins/tech-graph/scripts/check-deps.sh
+EOF
+exit 1

package/plugins/tech-graph/skills/tech-graph/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fireworks-tech-graph contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.