Updated 3w ago
by HsienW
ai-agent-engineering-playbook
🔨Reusable personal Agent Skills and practice-backed Q&A for AI Agent engineering, runtime reliability, multi-agent systems, evaluation, and AI-native frontend.
24 GitHub stars (24)
Steady at 24 stars — no new stars in the 16 days since Sep 30.
- 24 skills (24 skills found in its SKILL.md files)
- 0 forks (0 forks)
- 3w ago last update (Last updated 3w ago)
Install
Skills CLI
npx skills add HsienW/ai-agent-engineering-playbook
Asks which skills and agents to install. Just one: npx skills add HsienW/ai-agent-engineering-playbook --skill frontend-ui-engineering — add -g for every project.
Claude Code
git clone https://github.com/HsienW/ai-agent-engineering-playbookcp -r "ai-agent-engineering-playbook/skills-application-engineering/frontend-ui-engineering" ~/.claude/skills/
Copies the frontend-ui-engineering skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add HsienW/ai-agent-engineering-playbook
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
frontend-ui-engineering
Build production-quality frontend interfaces. Use when creating or modifying UI components, layouts, interaction states, responsive behavior, accessibility, visual polish, or user-facing workflows.
skills-application-engineering/frontend-ui-engineering/SKILL.md on GitHub (opens in a new tab) -
node-engineering
Guide robust Node.js and TypeScript engineering. Use when working on Node services, scripts, CLIs, tests, streams, async workflows, module boundaries, environment configuration, logging, caching, profiling, or graceful shutdown.
skills-application-engineering/node-engineering/SKILL.md on GitHub (opens in a new tab) -
api-and-interface-design
Guide stable API and interface design. Use when creating or changing public module boundaries, REST or GraphQL endpoints, event contracts, SDK methods, data transfer objects, error envelopes, or cross-team interfaces.
skills-contract-boundaries/api-and-interface-design/SKILL.md on GitHub (opens in a new tab) -
bff-transport-boundary
Design and review Backend-for-Frontend transport boundaries. Use when implementing or changing request parsing, response mapping, streaming proxy behavior, CORS, header allowlists, authentication boundaries, timeouts, cancellation, error envelopes, or upstream orchestration.
skills-contract-boundaries/bff-transport-boundary/SKILL.md on GitHub (opens in a new tab) -
frontend-streaming-contract
Design and review frontend streaming contracts. Use when handling server-sent events, WebSocket messages, async iterables, stream parsers, reducer state, terminal states, progress timelines, cancellation, retries, or UI updates driven by runtime events.
skills-contract-boundaries/frontend-streaming-contract/SKILL.md on GitHub (opens in a new tab) -
langgraph-backend-contract
Design and review LangGraph backend contracts. Use when creating or changing graph state, nodes, edges, reducers, commands, sends, checkpoints, runtime events, provider adapters, tool adapters, prompts, terminal states, or resumable workflows.
skills-contract-boundaries/langgraph-backend-contract/SKILL.md on GitHub (opens in a new tab) -
tool-renderer-contract
Design and review structured tool-result rendering. Use when rendering tool calls, tool messages, structured tool outputs, status cards, fallback JSON/text displays, parser boundaries, display status mappings, or unknown tool results.
skills-contract-boundaries/tool-renderer-contract/SKILL.md on GitHub (opens in a new tab) -
type-boundary-contract
Design and review type contracts across package, service, frontend, backend, tool, event, and transport boundaries. Use when defining schemas, discriminated unions, runtime parsers, error envelopes, schemaVersion fields, or duplicated transport/domain types.
skills-contract-boundaries/type-boundary-contract/SKILL.md on GitHub (opens in a new tab) -
code-review-and-quality
Conduct multi-axis code review. Use before merging code written by an agent or human, when assessing diffs for correctness, maintainability, security, tests, observability, and contract risk.
skills-delivery-practices/code-review-and-quality/SKILL.md on GitHub (opens in a new tab) -
debugging-and-error-recovery
Guide systematic root-cause debugging. Use when tests fail, builds break, runtime behavior is unexpected, logs show errors, or repeated fixes are not resolving the same issue.
skills-delivery-practices/debugging-and-error-recovery/SKILL.md on GitHub (opens in a new tab) -
incremental-implementation
Deliver changes in small verifiable increments. Use when implementing a multi-file feature, refactor, migration, bug fix, or any task that is large enough to become risky if completed in one pass.
skills-delivery-practices/incremental-implementation/SKILL.md on GitHub (opens in a new tab) -
test-driven-development
Drive implementation with tests. Use when fixing bugs, changing behavior, adding logic, modifying contracts, or proving that agent-written code works and remains safe across regressions.
skills-delivery-practices/test-driven-development/SKILL.md on GitHub (opens in a new tab) -
observability-and-instrumentation
Add or review observability. Use when adding logs, metrics, traces, audit events, health checks, alerts, or production diagnostics for features, background jobs, APIs, tools, and integrations.
skills-operational-hardening/observability-and-instrumentation/SKILL.md on GitHub (opens in a new tab) -
performance-optimization
Optimize application performance with evidence. Use when latency, throughput, memory, bundle size, rendering speed, Core Web Vitals, query time, startup time, or resource usage matters.
skills-operational-hardening/performance-optimization/SKILL.md on GitHub (opens in a new tab) -
security-and-hardening
Harden software against security risk. Use when handling user input, authentication, authorization, sessions, secrets, file uploads, external integrations, webhooks, browser data, storage, or privileged actions.
skills-operational-hardening/security-and-hardening/SKILL.md on GitHub (opens in a new tab) -
agent-observability-fault-tolerance
Design and review agent runtime observability and model/provider fault tolerance. Use when adding metrics, traces, cost tracking, audit alignment, structured runtime events, model fallback, structured output repair, refusal handling, provider timeouts, or local execution tree diagnostics.
skills-runtime-governance/agent-observability-fault-tolerance/SKILL.md on GitHub (opens in a new tab) -
agent-role-boundary-preflight
Check an agent's role, lifecycle ownership, target scope, and authorization immediately before any side effect. Use in multi-agent or role-separated workflows before writing code, specifications, configuration, tests, documentation, runtime artifacts, version control, or external systems, and whenever a task shifts from analysis, planning, or review into execution.
skills-runtime-governance/agent-role-boundary-preflight/SKILL.md on GitHub (opens in a new tab) -
agent-task-state-machine
Design and review generic agent task and step state machines. Use when adding business-level task progress, step lifecycle tracking, task events, persistence, streaming timelines, resumable task state, or cross-layer task status APIs.
skills-runtime-governance/agent-task-state-machine/SKILL.md on GitHub (opens in a new tab) -
compensation-saga-runtime
Design and review compensation and Saga runtime behavior for agent workflows. Use when handling multi-step side effects, rollback plans, irreversible actions, compensation ordering, manual escalation, cancellation cleanup, or audit-linked recovery flows.
skills-runtime-governance/compensation-saga-runtime/SKILL.md on GitHub (opens in a new tab) -
context-budget-governance
Design and review context budget governance for agent prompts and model calls. Use when assembling long conversation context, tool results, retrieved evidence, memory, task state, system rules, multimodal observations, or compressed summaries under a token budget.
skills-runtime-governance/context-budget-governance/SKILL.md on GitHub (opens in a new tab) -
distributed-step-lock
Design and review distributed locks for agent step transitions. Use when preventing concurrent workers, duplicate resumes, retries, compensation, or external requests from mutating the same task or step state at the same time.
skills-runtime-governance/distributed-step-lock/SKILL.md on GitHub (opens in a new tab) -
idempotency-audit-contract
Design and review idempotency and audit contracts for agent runtimes. Use when preventing duplicate side effects, propagating idempotency keys, persisting operation history, redacting sensitive payloads, auditing tool decisions, or reconstructing task execution after retries and resumes.
skills-runtime-governance/idempotency-audit-contract/SKILL.md on GitHub (opens in a new tab) -
langgraph-runtime-boundary-review
Review LangGraph native runtime boundaries before building custom agent runtime infrastructure. Use when deciding whether queueing, workers, checkpointers, stores, interrupts, resume flows, retries, task semantics, audit, locks, or cost tracking should be native runtime responsibilities or custom application runtime responsibilities.
skills-runtime-governance/langgraph-runtime-boundary-review/SKILL.md on GitHub (opens in a new tab) -
retry-budget-policy
Design and review retry budgets for agent steps, tools, providers, and transport calls. Use when classifying retryable errors, enforcing max attempts, respecting Retry-After, applying backoff and jitter, handling timeouts, or preventing retries for permission, validation, business, or user-cancelled failures.
skills-runtime-governance/retry-budget-policy/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.