Cursor-first · tool-agnostic by design

Agent skills for
real engineering

ai-kit is Polyms' shared brain for agentic fullstack dev — short-named skills you invoke with a slash command, from product requirements to shipped, reviewed code.

Get started Read the docs →

polyms/ai-kit · main

/align checkout refactor

→ 3 clarifying questions before spec

→ wrote docs/adr/0007.md

01 · principles

Real engineering.

01

Align before you build

/align closes the communication gap — grill decisions before /reqs or /to-prd.

02

Small and composable

Short-named skills (/reqs, /design, /dev) you combine per task — no heavyweight process.

03

Feedback loops

/dev encodes TDD, types, and debugging discipline — fast signal, not blind codegen.

04

Design every day

Specs name modules and seams; code skills resist the ball of mud agents accelerate.

05

Hack and own them

Fork, adapt, commit back — skills are yours, not black-box prompts.

02 · pipeline

One pipeline, start to ship.

Each stage produces artifacts the next agent consumes. Raw issues route in separately via /triage — verified and briefed before they reach /dev.

Idea

/alignAlign

/reqs | /to-prdReqs / To PRD

/to-issuesTo issues

/designDesign

/devDev

/code-reviewCode review

Ship

Principal agents

pm

Principal Product Manager

PRD, stories, acceptance criteria, scope

designer

Principal Product Designer

docs/design/ UI specs, @polyms/ui-kit maps

developer

Principal Software Engineer

Implementation, TDD, /devops (primary)

tester

Principal Tester

E2E harness, flake, CI sharding, journeys

techlead

Principal Tech Lead

/docs, arch, code-review, arch-refactor; /devops SEV

03 · catalog

Fifteen skills. Zero ceremony.

Each capability is a short-named skill or agent, invoked with a slash command.

Prepare a repo so ai-kit can find your issue tracker, domain docs, and agent pointers.

Agree on the plan before you build — grill decisions one question at a time, sharpen domain words, update CONTEXT.md as you go.

Requirements work — discovery, enterprise PRD, user stories, acceptance criteria, scope, and prioritization. Does not publish to the tracker.

Turn the current conversation into a lean PRD and publish it as a tracker issue — no extra interview.

Break a plan, spec, or PRD into GitHub issues that can be picked up independently — one vertical slice per issue.

Move GitHub issues through triage — categorize, verify, grill if needed, and attach agent briefs.

Turn a PRD or feature brief into an engineering-ready UI spec mapped to @polyms/ui-kit.

Ship production code from a spec — TDD at confirmed seams, solution ladder, scope check, and debugging.

Review code since a pinned git baseline — Standards, Spec, and Simplify.

Write developer docs — API reference, tutorials, integration guides, and migration notes.

End-to-end test automation — Playwright flakes, CI parallelization, journey suites, and traces.

Guide for writing and editing ai-kit skills — keep them predictable, prune sprawl, get invocation right.

Scan the codebase for deepening opportunities, show a visual HTML report, then grill the candidate you pick.

Architecture vocabulary for deep modules — seam, depth, leverage, locality, design-it-twice.

Deploy, CI, and infra — go from symptom to fix via Knowledge (`intent: incident`), with SEV and post-mortem templates.

04 · quickstart

Ninety seconds to first /align.

One command installs every skill into Cursor. Restart your editor and type `/` to pick one.

polyms/ai-kit ↗

zsh — npx skills

npx skills add \

https://github.com/polyms/ai-kit \

--skill '*' -a cursor -g

installs skills into ~/.cursor/skills