Johnweek Agent18

Johnweek Agent18 Plugin

Personal Claude Code plugin for Johnweek workflows. Provides expert skills for Rust, TypeScript, security, cryptography, DevOps, and design.

---

Installation

1. Register the marketplace

/plugin marketplace add hungnguyen18/your-skill-18

This registers the your-skill-18 GitHub repo as a plugin marketplace.

2. Install the plugin

/plugin install johnweek-agent18

3. Verify it's enabled

/plugin list

You should see johnweek-agent18 listed and enabled. Once enabled:

• CLAUDE.md is automatically loaded into every session as context.
• All skill files under skills/ become available.
• Hooks in hooks/hooks.json activate automatically — no manual settings.json editing required.

4. Confirm hooks are active

/hooks

You should see SessionStart and UserPromptSubmit entries from the Johnweek plugin. If not, ensure the hook scripts are executable:

chmod +x ~/development/your-skill-18/plugins/johnweek-agent18/hooks/*.sh

---

How Enforcement Works

The plugin uses two hooks to guarantee Johnweek standards are followed on every task:

Hook	Event	Behaviour
session-start.sh	SessionStart	Fires once when a session opens. Injects the full list of active skills and core rules into context.
enforce-skills.sh	UserPromptSubmit	Fires before every message. Pattern-matches the prompt for task type (TypeScript backend/frontend, Rust, security, etc.) and injects the matching SKILL.md content into Claude's context before it responds.

Skills that are auto-detected and enforced:

Detected keywords	Skill injected
typescript, node.js, fastify, graphql, express, backend, kysely, rabbitmq, pino, json-rpc	typescript-backend
react, next.js, frontend, component, wagmi, viem, tailwind, wallet	typescript-frontend
rust, cargo, tokio, zero-knowledge, wasm, cryptograph, seaorm	rust
security audit, vulnerability, pentest, threat model	security-expert
/security	security (workflow)
/refactor	refactor (workflow)
/upgrade	upgrade (workflow)

---

Skills

Expert Roles (context-activated)

Skill	Activates when...
rust	Writing/reviewing Rust, ZK circuits, crypto, WASM
typescript-backend	Node.js services, GraphQL/REST/JSON-RPC APIs, Kysely, server-side Web3
typescript-frontend	React/Next.js App Router, wagmi/viem, TailwindCSS, wallet UI
designer	Implementing Figma designs in React/Next.js
devops	Working with Docker, Kubernetes, CI/CD, monitoring
security-expert	Threat modeling, security design, ZK/Web3 security review
cryptography-expert	ZK proofs, ECC, hash functions, commitment schemes, VRF

Workflow Actions (on-demand)

Skill	What it does
security	Full-stack security audit → SECURITY-yyyy-mm-dd.md
refactor	Safe codebase refactor → REFACTOR-yyyy-mm-dd.md
upgrade	Dependency upgrades (Rust + Node.js) → UPGRADE-yyyy-mm-dd.md

---

Structure

johnweek-agent18/
├── CLAUDE.md              # Plugin context loaded into every session
├── README.md              # This file
├── hooks/
│   ├── hooks.json         # Hook declarations (auto-loaded by the plugin)
│   ├── session-start.sh   # SessionStart: injects Johnweek rules on session open
│   └── enforce-skills.sh  # UserPromptSubmit: injects matching SKILL.md per task
├── rules/                 # Engineering standards
│   ├── security-first.md
│   ├── code-review-standards.md
│   ├── johnweek-stack.md
│   └── git-model.md
└── skills/                # Skill definitions
    ├── rust/
    ├── typescript-backend/
    ├── typescript-frontend/
    ├── designer/
    ├── devops/
    ├── security-expert/
    ├── cryptography-expert/
    ├── security/
    ├── refactor/
    └── upgrade/

Each skill contains a SKILL.md (workflow + phase guide) and a references/ directory with deep-dive standards documents.

---

Uninstalling

/plugin remove johnweek-agent18

Hooks and skill enforcement are removed automatically when the plugin is disabled.