AI tools and agent skills

Coding agents use short skill documents for consistent practices. This page lists project skills (in the monorepo) and global skills (user machine), with links to skills.sh.

Scope	Location	Role
Project	`.agents/skills/`	Shared catalogue for this monorepo
Project	`.claude/skills/`	Claude-oriented skills (`orient`, `handoff`) + symlinks into `.agents`
Global (user)	`~/.agents/skills/`	User-wide skills via `npx skills add`
Global (user)	`~/.claude/skills/`, `~/.grok/skills/`	Often symlinks into `~/.agents/skills/`
Grok bundled	`~/.grok/bundled/skills/`	Skills shipped with Grok (not managed by skills.sh)

Each skill’s entry point is SKILL.md. Browse or install:

bash

npx skills find "<name>"
npx skills add <owner/repo@skill>     # → ~/.agents/skills by default
npx skills list

Global install metadata: ~/.agents/.skill-lock.json.

Session hooks are separate — see Claude Code hooks and Grok hooks.

Global skills (`~/.agents/skills`)

User-global skills available across projects (current machine install). Claude/Grok may expose the same names via symlinks under ~/.claude/skills/ and ~/.grok/skills/.

Title	Short description	skills.sh
designing-beautiful-websites	UX/UI for sites and apps: strategy, IA, flows, wireframes, component specs, visual polish.	tristanmanchester/agent-skills/designing-beautiful-websites
find-skills	Discover and install agent skills when asking “is there a skill for…?” / “how do I…?”.	vercel-labs/skills/find-skills
nx-workspace	Explore Nx workspaces, projects, targets, and failed `nx` commands.	nrwl/nx-ai-agents-config/nx-workspace
playwright-best-practices	Playwright tests: flaky fixes, POM, CI, mocking, a11y, performance patterns.	currents-dev/playwright-best-practices-skill/playwright-best-practices
playwright-cli	Automate browser interaction and author Playwright tests via CLI.	microsoft/playwright-cli/playwright-cli
pnpm	pnpm workspaces, catalogs, patches, overrides, virtual store.	antfu/skills/pnpm
redesign-existing-projects	Audit and upgrade UI quality; remove generic AI design patterns.	leonxlnx/taste-skill/redesign-existing-projects
security-best-practices	Language/framework security reviews when the user explicitly asks for best practices.	openai/skills/security-best-practices
security-review	Security code review for vulnerabilities (OWASP-style audit prompts).	getsentry/skills/security-review
turborepo	Turborepo pipelines, caching, `--filter` / affected, monorepo task graph.	vercel/turborepo/turborepo

Note: Global skills are not in the git tree. They follow the developer machine. After npx skills add / update, refresh this table from ~/.agents/skills/ and ~/.agents/.skill-lock.json.

Grok user skills (`~/.grok/skills`)

Besides symlinks into ~/.agents/skills/, Grok may keep tool-specific user skills here (e.g. check-work, create-skill, help, imagine, code-review). Those are Grok-local rather than skills.sh installs.

Project skills — `.agents/skills`

Title	Short description	skills.sh
accessibility	Audit and improve web accessibility following WCAG 2.2.	addyosmani/web-quality-skills/accessibility
clean-code	Apply Clean Code principles — readable, maintainable modules.	sickn33/antigravity-awesome-skills/clean-code
next-best-practices	Next.js conventions: files, RSC boundaries, data, metadata, bundling.	vercel-labs/openreview/next-best-practices
next-upgrade	Upgrade Next.js using official migration guides and codemods.	vercel-labs/openreview/next-upgrade
playwright-cli	Automate browser interaction and author Playwright tests via CLI.	microsoft/playwright-cli/playwright-cli
react-performance	React/Next performance patterns (waterfalls, bundle, re-renders).	affaan-m/everything-claude-code/react-performance
responsive-design	Container queries, fluid type, CSS Grid, mobile-first breakpoints.	wshobson/agents/responsive-design
sanity-best-practices	CMS schemas, GROQ, TypeGen, Studio, Visual Editing, integrations.	sanity-io/agent-toolkit/sanity-best-practices
seo-audit	Technical SEO audit: meta, crawl, Core Web Vitals, diagnostics.	coreyhaines31/marketingskills/seo-audit
solid	SOLID principles, TDD, design patterns, senior design discipline.	ramziddin/solid-skills/solid
typescript-expert	Strict TypeScript, monorepo tooling, type-level patterns.	sickn33/antigravity-awesome-skills/typescript-expert
vercel-composition-patterns	Compound components, lifting state, React 19 composition APIs.	vercel-labs/agent-skills/vercel-composition-patterns
vercel-react-best-practices	Vercel Engineering React/Next performance rules (70+ checks).	vercel-labs/agent-skills/vercel-react-best-practices
web-design-guidelines	Review UI against Web Interface Guidelines compliance.	vercel-labs/agent-skills/web-design-guidelines
web-design-reviewer	Visual inspection of local/remote UIs; fix design issues at source.	github/awesome-copilot/web-design-reviewer
write-discoverable-code	Name and structure code for plain-text search by agents and humans.	modem-dev/skills/write-discoverable-code

Project skills — `.claude/skills`

Title	Short description	skills.sh / notes
orient	Read-only orientation: commands, git state, health — before editing.	Project-local. Related: camacho/ai-skills/orient
handoff	Session handoff summary from git status/diff/log for the next session.	Project-local. Related: mattpocock/skills/handoff
responsive-design	Symlink into `.agents/skills/responsive-design`	wshobson/agents/responsive-design
web-design-reviewer	Symlink into `.agents/skills/web-design-reviewer`	github/awesome-copilot/web-design-reviewer

Session lifecycle: Claude Code sessions.

Using skills

Project vs global: project skills travel with the repo; global skills travel with the developer machine.
Invoke the skill that matches the task rather than re-deriving rules from chat memory.
Skills are not a substitute for ADRs under Decisions or for ops pages under Ops.
When adding or removing skills, update the matching table and the internal twin under docs/ai/skills.md.

AI tools and agent skills ​

Global skills (~/.agents/skills) ​

Grok user skills (~/.grok/skills) ​

Project skills — .agents/skills ​