@noob-factory/agent-skills

Four AI coding-assistant skills that work across Claude Code, Gemini CLI, Codex, and puku-cli — one install, every tool.

| Skill | What it does | | --- | --- | | noob-explain | Compact, diagram-first plain-English breakdowns of any system, doc, code path, ticket, or report. Supports -short / -medium / -long / -auto modes. Auto-saves big visual outputs to noob-explained/ in the user's current working directory. | | analyze-repo | Generates canonical project docs (README, ARCHITECTURE, AGENTS.md) from scratch when a repo has none. | | update-agents-context | Refreshes an existing AGENTS.md and companion context docs from current code after a feature, refactor, or API change. | | desktop-notifier | Surfaces OS-level desktop notifications (Windows toast / macOS Notification Center / Linux libnotify) when puku-cli needs user attention — permission prompts, idle prompts, agent awaiting input, multi-agent teammate prompts, and elicitation dialogs. Fires via a Notification hook with a 4-tier backend fallback chain. |

Skills are plain Markdown following the open SKILL.md spec — any agent that reads the spec picks them up automatically.

Default install: every supported agent at once

By default npm install copies the skills into all of:

flowchart LR
  Pkg["@noob-factory/agent-skills<br/>(npm install)"] --> Puku[".puku-cli/skills/"]
  Pkg --> Claude[".claude/skills/"]
  Pkg --> Gemini[".gemini/skills/"]
  Pkg --> Codex[".agents/skills/"]
  Puku -.skills.-> PukuAgent[puku-cli]
  Claude -.skills.-> ClaudeAgent[Claude Code]
  Gemini -.skills.-> GeminiAgent[Gemini CLI]
  Codex -.skills.-> CodexAgent[Codex]

Caption: one npm install writes the same skills into all four agent directories.

The noob-explain skill auto-saves big visual outputs to ./noob-explained/ in the user's current working directory (typically a project repo). The terminal always shows a headline. Add noob-explained/ to your project's .gitignore — these breakdowns are scratch notes, not committed docs.

| Agent | Skills directory (Windows shown; ~ works on macOS/Linux) | | --- | --- | | puku-cli | ~/.puku-cli/skills/ | | Claude Code | ~/.claude/skills/ | | Gemini CLI | ~/.gemini/skills/ | | Codex | ~/.agents/skills/ |

Install

# Global (recommended for personal use)
npm install -g @noob-factory/agent-skills

# Or as a project dev-dependency
npm install --save-dev @noob-factory/agent-skills

The postinstall step copies the skills into every detected agent dir. If an agent dir doesn't exist or isn't writable, it's skipped with a warning — the install never fails because of an optional target.

Pick a subset of agents

# Only Claude Code
npx @noob-factory/agent-skills install --only claude

# Everyone except Gemini and Codex
npx @noob-factory/agent-skills install --skip gemini,codex

# Single custom directory (overrides all defaults)
npx @noob-factory/agent-skills install --target ~/my-skills

CLI

agent-skills install [--target DIR] [--only AGENT] [--skip AGENT] [--force]
agent-skills list
agent-skills remove <name>... [--only AGENT]
agent-skills where

• --only and --skip accept comma-separated agent keys: puku, claude, gemini, codex.
• --target DIR switches to single-target mode (skips multi-agent defaults).
• --force overwrites existing skills of the same name.

Render Mermaid diagrams in VS Code

The noob-explain skill emits Mermaid diagrams. GitHub renders them automatically. For local preview in VS Code, install the extension:

Markdown Preview Mermaid Support — extension ID bierner.markdown-mermaid

It's a one-click install from the VS Code marketplace, no config needed.

License

MIT