Skip to content

guillempuche/ai-standards

v1.9.0MIT

AI coding skills and agents for TypeScript, React, Effect, local-first apps, unikernels, and accessibility

AI Standards

Open-source AI coding skills for Claude Code, Codex, Gemini CLI, OpenCode, Mastra Code, Cursor, Copilot, and any agent that reads Agent Skills

Skills for TypeScript, React, React Native, local-first apps, offline sync, and modern web development.

Quick Install

Any agent

The skills CLI installs into Codex, OpenCode, Gemini CLI, Cursor, Copilot, Claude Code, and 70+ other agents. It detects which agents you have installed and asks which skills to add.

# Pick skills interactively
npx skills add guillempuche/ai-standards

# One skill, into specific agents
npx skills add guillempuche/ai-standards --skill powersync -a codex -a opencode

Codex CLI

codex plugin marketplace add guillempuche/ai-standards

# Full bundle (all skills), or any single skill
codex plugin add ai-standards@ai-standards
codex plugin add powersync@ai-standards

Codex lists the skills from .agents/plugins/marketplace.json. The agents in agents/ are Claude Code-only, so Codex doesn't list them.

Claude Code

# Full bundle (all skills + agents)
/plugin marketplace add guillempuche/ai-standards

# Or install individually
/plugin marketplace add guillempuche/ai-skill-powersync
/plugin marketplace add guillempuche/ai-skill-effect-lookup
/plugin marketplace add guillempuche/ai-skill-unikraft
/plugin marketplace add guillempuche/ai-skill-tamagui
/plugin marketplace add guillempuche/ai-skill-test-bdd
/plugin marketplace add guillempuche/ai-skill-commit
/plugin marketplace add guillempuche/ai-skill-pr
/plugin marketplace add guillempuche/ai-skill-issue
/plugin marketplace add guillempuche/ai-agent-readability-improver
/plugin marketplace add guillempuche/ai-agent-a11y-accessibility-reviewer

Antigravity CLI

Antigravity CLI replaced Gemini CLI for unpaid and Google One users in June 2026.

agy plugin install https://github.com/guillempuche/ai-skill-powersync

Install skills from their own repos rather than the bundle: the bundle also ships agents/, whose Claude Code format Antigravity may not load.

Gemini CLI

gemini skills install https://github.com/guillempuche/ai-standards.git --path skills/powersync

Gemini CLI is still available on paid tiers.

Manual

Copy a folder from skills/ into the directory your agent reads, see Compatibility. .agents/skills/ covers most agents; Claude Code needs .claude/skills/.

Skills Catalog

powersync

Build local-first, offline-capable apps with real-time sync

PlatformsWeb, React Native, Node.js, Capacitor, Electron
FrameworksReact, Vue, Angular
ORMsKysely, Drizzle, TanStack DB
BackendsPostgres, MongoDB, MySQL, SQL Server, Supabase

View skill | PowerSync docs


effect-lookup

Quick lookup for Effect TypeScript library APIs and patterns

CoverageCore Effect, Platform, CLI, RPC, SQL, AI packages
FeaturesModule reference, common patterns, source code lookup
IncludesOptional MCP server integration for indexed docs

View skill | Effect docs


unikraft

Kraft CLI for building and deploying Unikraft unikernels

CommandsBuild, deploy, manage instances, volumes, services
PlatformUnikraft Cloud (KraftCloud)
FeaturesRolling updates, scale-to-zero, compose support

View skill | Unikraft docs


tamagui

Universal React + React Native UI with optimizing compiler

PlatformsWeb, React Native, iOS, Android
FrameworksNext.js, Expo, Vite, Metro
FeaturesDesign tokens, themes, 50+ accessible components
CompilerBuild-time style extraction for performance

View skill | Tamagui docs


test-bdd

Generate BDD-style tests that document behavior and test public API only

StyleGIVEN / WHEN / THEN / AND comments (flexible combinations)
ToolingVitest + testing-library (TypeScript-first, framework-agnostic principles)
CoversComponents, hooks, utilities, constants
FocusObservable behavior over implementation details

View skill


commit

Write and validate commit messages in a Conventional-Commits house style

Formattype(scope): subject, past-tense body bullets, issue-closing trailers
PortableScopes, extra types, and the formatter come from the repo, not the skill
FocusIntent over mechanism; plain language a non-technical reader can follow

View skill


pr

Take a finished branch through verification, self-review, and merge

CoversRe-baseline, end-to-end verification, self-review, gates, body, merge
PortableGates, CI shape, worktrees, and companion skills are read from the repo
Requiresgit; the pull-request steps assume GitHub and the gh CLI

View skill


issue

Turn a rough ask into a well-formed GitHub issue

CoversInterview, duplicate check, type-aware draft (bug/feature/task), labels
PortableLabels, areas, and attribution are read from the repo, not the skill
Requiresgit; assumes GitHub and the gh CLI

View skill


Agents Catalog

readability-improver

Improve code readability through renaming, comments, and whitespace

FocusSelective improvements - skips self-documenting code
ActionsRename variables, add whitespace, document "why" not "what"
SafetyNever changes functionality, updates all imports

View agent


a11y-accessibility-reviewer

Review and fix accessibility issues (WCAG, VoiceOver, TalkBack)

PlatformsReact, React Native, Web
StandardsWCAG 2.1/2.2, WAI-ARIA, iOS/Android a11y APIs
CoverageVisual, motor, auditory, cognitive, vestibular, seizure

View agent


Compatibility

Skills follow the Agent Skills specification, so the same SKILL.md folders work in every agent below.

AgentProject skillsUser skills
Claude Code.claude/skills/~/.claude/skills/, or install as a plugin
Codex.agents/skills/~/.agents/skills/, or install as a plugin
Gemini CLI.agents/skills/, .gemini/skills/~/.agents/skills/, ~/.gemini/skills/
OpenCode.agents/skills/, .opencode/skills/, .claude/skills/~/.agents/skills/, ~/.config/opencode/skills/, ~/.claude/skills/
Mastra Code.mastracode/skills/, .claude/skills/, .agents/skills/~/.mastracode/skills/, ~/.claude/skills/, ~/.agents/skills/
Antigravity.agents/skills/~/.gemini/antigravity-cli/skills/ (CLI), ~/.gemini/config/skills/ (app and IDE), or install as a plugin
Cursor, GitHub Copilot, and otherssee the skills CLI agent table

allowed-tools is experimental in the spec: Claude Code uses it to pre-approve the listed tools for the turn, and support in other agents varies (the skills CLI table marks Kiro CLI and Zencoder as not supporting it).

Agents in agents/ use the Claude Code subagent format and only load in Claude Code. Other tools define subagents differently (Codex, for example, uses TOML files), so copy the prompt body if you want one elsewhere.

Creating Skills

  1. Create folder under skills/ with lowercase hyphenated name
  2. Add SKILL.md with YAML frontmatter:
---
name: your-skill
description: What it does and when to use it (max 1024 chars)
license: MIT
metadata:
  author: your-name
  version: 1.0.0
---

# Your Skill

Instructions here...
  1. Add references/ folder for detailed docs (keeps SKILL.md under 500 lines)

See AGENTS.md for full guidelines.

Naming Conventions

Plugin names and GitHub repo slugs follow different conventions on purpose:

SurfaceConventionExample
Marketplace plugin name (/plugin UI, /plugin install)topic only, kebab-casepowersync, test-bdd, readability-improver
GitHub repo slug (/plugin marketplace add guillempuche/…)ai-{skill|agent}-{topic}guillempuche/ai-skill-powersync, guillempuche/ai-agent-readability-improver
Mixed-type escape hatch (repo bundles both skills and agents)ai-plugin-{topic}guillempuche/ai-plugin-toolbox

Why the split: repo slugs are user-typed during marketplace add (one-time, and guillempuche/powersync would look like a library fork). Plugin names live inside the /plugin UI where users already know they're browsing Claude plugins, so a prefix would be noise.

Install command shape combines both:

/plugin install powersync@guillempuche-ai-skill-powersync
#              └─plugin──┘ └────── marketplace ──────┘

Repository Structure

ai-standards/
├── .claude-plugin/
│   └── plugin.json          # Claude Code plugin manifest
├── skills/
│   └── <skill-name>/
│       ├── SKILL.md         # Main skill file
│       └── references/      # Detailed documentation
├── agents/
│   └── <agent-name>.md      # Agent with YAML frontmatter
├── templates/
│   ├── skills/              # Extra files for skill repos (REQUIREMENTS.md)
│   └── agents/              # Extra files for agent repos
├── scripts/
│   ├── generate-individual-repos.sh  # Generate dist-repos/
│   └── create-github-repos.sh        # Push to GitHub
├── AGENTS.md                # AI agent instructions
└── README.md

Individual Repos

Skills and agents are also published as individual repos for standalone installation:

# Add the marketplace (one-time, uses repo slug)
/plugin marketplace add guillempuche/ai-skill-powersync
/plugin marketplace add guillempuche/ai-agent-readability-improver

# Install the plugin (plugin name is topic-only, marketplace suffix is repo-slug form)
/plugin install powersync@guillempuche-ai-skill-powersync
/plugin install readability-improver@guillempuche-ai-agent-readability-improver

Generate individual repos with:

./scripts/generate-individual-repos.sh  # Creates dist-repos/
./scripts/create-github-repos.sh        # Pushes to GitHub

Standards

  • Agent Skills - Portable skill format for AI coding agents
  • AGENTS.md - Instructions for AI agents working on repositories

Contributing

  1. Fork this repository
  2. Create your skill under skills/ following the structure above
  3. Validate: folder name matches name field, description under 1024 chars
  4. Submit PR with title: [skill-name] Brief description

License

MIT