Skip to content

About

Personal agent plugin for Nuxt/Vue/TS development

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

0 watching

Forks

Repository files navigation

harlan-agent-kit banner

harlan-agent-kit

πŸ€– My agent kit for Nuxt and TypeScript work. 36 Skills, 8 hooks, and a service that works my GitHub repos on its own.

It installs as a Claude Code plugin. Codex reads the same directory and picks up the Skills.

Made possible by my Sponsor Program πŸ’–
Follow me @harlan_zw 🐦 β€’ Join Discord for help

Important

These are my defaults, not general advice. Fork it and change what you disagree with.

Features

  • 🎨 Nuxt frontends: Build on Nuxt UI v4+, then review the result by running it, not by reading it
  • 🧠 Architecture review: Separate rubrics for a Nuxt app and a plain TypeScript package
  • πŸ“¦ Package conformance: One pass over workspace catalogs, ESLint, Vitest, CI, and playgrounds
  • ✍️ Writing: PRs, changelogs, tweets. Plus a pass that strips the AI tells back out
  • πŸ“‹ Triage: Issues, the PR backlog, Sentry, and the inbox
  • πŸͺ Hooks: pnpm only. Lint on save. Checks before every push
  • πŸ€– GitHub agent: A local service that opens the work on issues and PRs while I do something else

How I use it

My main checkout stays clean, I never work in it. Every task gets its own worktree with worktrunk. The agent works in there and it can't commit or push until check passes, so lint, typecheck and tests. Then the pr Skill opens the PR. The hooks block the command if any of that gets skipped, which is good, because I skip things when I'm tired.

The other part runs on its own. I've got a service on my machine that checks my repos, finds an issue or a PR that's been sitting there, and gives it to Codex or opencode. It reviews the thing but can't touch the code. If it finds something real, a second agent does the fix, then the whole thing gets reviewed again. I don't want the same agent marking its own homework.

The bit I still have to do is read all of it. That's the slow part, not the agents. So I make them show me something first: a test that was failing and now passes, a typecheck, or for frontend work the page running in a browser. Small stuff like dependency bumps merges without me. If there's a real decision in it, it waits.

Get Started

Claude Code

/plugin marketplace add harlan-zw/harlan-agent-kit
/plugin install harlan-agent-kit

Install a local checkout instead when you are changing the plugin:

/plugin install /path/to/harlan-agent-kit

Codex

Codex installs the nested plugin directory, harlan-agent-kit/, from this checkout's marketplace.

codex plugin marketplace add "$PWD"
codex plugin add harlan-agent-kit@harlan-agent-kit

The plugin carries the Skills. Codex copies it into its cache, and pnpm sync:context refreshes that copy. The guards run as user hooks from ~/.codex/hooks.json, which pnpm sync:context writes. Trust them once in /hooks, or in Settings > Hooks in the desktop app. Codex trusts a plugin hook against the whole plugin, so a plugin hook would need review after every kit change. A user hook keeps its trust until its definition changes.

Skills

Personal Skills live in harlan-agent-kit/skills/. Portable Skills come from Brundlefly and Ripast. The Ripast skill lives in Ripast's repository. The declaration pins its source commit. Run pnpm sync:skills to install the declared Skills through skilld. Use a skilld CLI that supports skilld sync. Brundlefly delivery uses verified skilld artifacts from its public repository. The command preserves unrelated installed Skills and refuses name conflicts. It adopts existing links only when their files match the pinned source. Run pnpm check:skills to check installed content, targets, and required Skills. Skills reach Codex, Claude Code, and OpenCode through the same declaration. The dedicated store lives at ~/.local/share/harlan-agent-kit/skilld. The existing skilld store keeps its files. Service updates run the same restore before starting workers on either host.

Brundlefly Skill Use
im-part-human Edit prose while preserving facts and voice. Replaces im-not-a-fly, write-human, and humanize-writing.
technical-guide Research and verify individual technical articles.
release-notes Write release notes that help readers decide whether to upgrade and understand required changes.
im-not-a-human Compress agent text while preserving its meaning. Replaces im-a-fly and agentify-text.
pull-request-summary Check PR description text before personal pr publishes it.
glossary Create or audit GLOSSARY.md for names and vocabulary drift.
copywriting Create or audit COPY.md for voice and canonical wording.

skilld.json declares exact sources, Agent targets, and required Skills. Personal pr calls Brundlefly pull-request-summary for its description gate. Personal pr owns Hooks, publication, Review, and Service policy. content-refresh coordinates collections and uses technical-guide for each technical article. Brundlefly's release-notes owns release text and its evidence. The declaration installs it alongside the other portable writing Skills. The personal kit does not bundle this Skill in its marketplace package. Run pnpm sync:skills from this checkout.

Skill Description
adversarial-review Review one PR adversarially, hand defects to Repair, publish the bot status
agent-feedback Improve one Agent Skill from explicit Review feedback
brand-lab Compare brand directions for a logo and UI motifs on one private page
browser Select Chrome identities, use prompt-free debugging, and clean up task tabs
content-refresh Refresh articles through verified sources, reviewed briefs, screenshots, and publication checks
email-triage Review inbox email with Himalaya and propose actions
email-usage Choose email addresses, Himalaya accounts, and mail permissions
harlan-github-agent Drive or diagnose the local GitHub service
i-dont-know-just-keep-working Find related gaps, bugs, and improvements, then rank next steps by impact, effort, and confidence
improve-ts-pkg-architecture Find architecture improvements in a TypeScript package
issue-triage Rank open issues by impact and difficulty
nuxt-frontend-design Build and polish Nuxt UI v4+ pages and design systems
nuxt-frontend-review Run a Nuxt frontend and check it against its contract
nuxt-improve-codebase-architecture Find Nuxt-native architecture improvements
nuxt-4-minors-migration Move a Nuxt 4 site to the latest 4.x release with compatibility version 5, and migrate what the minors changed
pkg-conform Conform or scaffold a TypeScript package or Nuxt module
plan-ceo Challenge scope and strategy before anyone writes code
pr Create or update a pull request from current work
pr-lens Draw a change as animated architecture and data-flow diagrams with PR Lens
pr-triage Repair, rank, and order the owned PR backlog
daily-checkin Run nuxt-checkin and interpret site prompt items
dependency-updates Attempt weekly dependency updates, including majors, in one pull request
ci-review Review CI warnings and errors, then propose verified repairs
seo-review Triage a Site's NuxtSEO actions and repair the ones the code owns
vitals-review File a Site's poor field vitals and persistent lab drops from NuxtSEO, then repair them
sentry-checkin Triage open Sentry issues and repair them with verified PRs
take-ownership Finish delivery, reconcile loose ends, and clean task-owned Git state
ts-design-patterns Apply the Effect-inspired TypeScript design principles
tweet Find tweet ideas, plan launch posts, and draft tweets with visuals
unit-tests Write or review unit tests through exported behavior

Hooks

Claude Code reads the hooks from .claude-plugin/plugin.json. That manifest is the only place a hook is registered. The install script, the drift check, and the opencode plugin all derive their lists from it. Codex reads ~/.codex/hooks.json, which pnpm sync:context renders from hooks/codex.json. pnpm test:codex-hooks fails when its Bash guards differ from the Claude manifest.

Event Hook Description
SessionStart session-start.sh Detect the project type, print the Git state
PreToolUse (Bash) pnpm-only.sh Block npm, yarn, and npx
PreToolUse (Bash) wt-only.sh Keep every worktree owned by wt
WorktreeCreate wt-worktree-create.sh Create Claude Code worktrees with wt, from the caller's HEAD
WorktreeRemove wt-worktree-remove.sh Remove them with wt, never with force
PreToolUse (Bash) himalaya-read-only.sh Keep every agent's email access read only
PreToolUse (Bash) pr-skill-only.sh Require the pr Skill to open a PR or edit its description
PreToolUse (Bash) merged-branch-guard.sh Block commits on an already merged branch
PreToolUse (Bash) pre-commit-push.sh Run check before a commit, push, or PR
PostToolUse (Write, Edit) eslint.sh Autofix lint on the file that changed
PostToolUse (Bash) command-not-found.sh Recover from a missing shell command

Two more scripts run outside the hook events: check.sh runs the configured project checks, and check-config.sh reads the per-project config the others source.

Turn a hook off for one project with .claude/hooks.json:

{
  "disabled": ["eslint", "pre-commit-push"]
}

GitHub Agent

packages/harlan-github-agent is a local service. It watches my repositories, runs Agents on the issues and pull requests it finds, and shows the result on a dashboard. Reviews are read only, and every material finding goes to a fresh Repair Agent, so nothing merges on the reviewer's own word.

pnpm service:status    # Show the service state
pnpm service:update    # Rebuild and restart

packages/octorun consumes the standalone Octorun runtime for this repository. It runs automatic change summaries and explicit @octorun review commands with the existing App and Claude subscription. Run pnpm octorun doctor, then pnpm octorun serve for continuous processing.

Reference

The Skills defer to these when the rules get long:

Design notes for the service live in docs/plans/.

Development

No build step for the plugin itself: bash hooks plus markdown Skills. The service in packages/ does build.

pnpm install
check                 # Parallel lint, typecheck, and test
pnpm lint:fix         # ESLint autofix
pnpm check:context    # Check the shared agent context for drift
pnpm release patch    # Bump the version, tag it, push it

Sponsors

License

Licensed under the MIT license.

About

Personal agent plugin for Nuxt/Vue/TS development

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages