Skip to main content

Gesso Skills

Agent skills for AI-assisted development with the Gesso Framework.

Installation​

Claude Code (plugin)​

/plugin marketplace add https://git.acromedia.com/acromedia/gesso/gesso.git

Available Skills​

gesso-react​

Discovery skill that triggers for Gesso work and delegates version-matched knowledge and scaffolding to the Gesso CLI.

  • In a Gesso project, agents start with pnpm gesso agent; otherwise they use pnpm dlx @acromedia/gesso-cli agent.
  • The pnpm dlx path requires Acro registry authentication; follow the registry authentication guide.
  • The CLI then directs component and rules discovery and the create or init setup workflow.
/plugin install gesso-react@gesso-skills

Other agents (Cursor, Codex, Antigravity, …)​

The skill uses the portable SKILL.md format and installs into any supported agent with the skills CLI. From your project root:

DO_NOT_TRACK=1 npx skills add git@git.acromedia.com:acromedia/gesso/gesso.git --skill gesso-react

The CLI detects the agents in your project and copies the skill into each one's skills directory (e.g. .claude/skills/, .agents/skills/). Requires SSH access to git.acromedia.com. DO_NOT_TRACK=1 disables the CLI's install telemetry so the private repository is never reported to the public skills.sh directory.

Installs come from the main branch. To update, re-run the same command.

Requirements​

  • An agent that supports SKILL.md skills — Claude Code, Cursor (2.4+), Codex CLI, Google Antigravity, Gemini CLI, and others
  • A project using the Gesso framework
  • GitLab (git.acromedia.com) access

Benchmarking (Internal)​

Evaluates skill quality by comparing AI-generated code with and without the skill against a quality checklist.

1. Create a test project​

# From the gesso repo root
./starter-kits/create-gesso/bin/create-gesso.js base_line_a --useLocal true
./starter-kits/create-gesso/bin/create-gesso.js base_line_b --useLocal true

2. Add CLAUDE.md to each project​

  • Without design-system: copy skills/benchmark/CLAUDE.example.md → CLAUDE.md
  • With design-system: copy skills/benchmark/CLAUDE.with_design_example.md → CLAUDE.md

3. Run benchmarks​

From each project directory:

# Side A — without skill (run in base_line_a)
cd base_line_a
node ../gesso/skills/benchmark/run-benchmark.mjs \
  --plugin-dir ../gesso/skills/gesso-react --side a

# Side B — with skill (run in base_line_b)
cd base_line_b
node ../gesso/skills/benchmark/run-benchmark.mjs \
  --plugin-dir ../gesso/skills/gesso-react --side b

4. Evaluate results​

# Without design-system
node ../gesso/skills/benchmark/generate-report.mjs \
  --results ./benchmark-results --evaluate

# With design-system
node ../gesso/skills/benchmark/generate-report.mjs \
  --results ./benchmark-results --evaluate --project

The evaluator dynamically searches the project for generated code and scores it against the quality checklist. Results are saved to benchmark-results/<run-id>/report.md.