Commands

Every command runs with npx github:dawidolko/frontend-skills <command> and accepts --cwd <dir> and --help. Output is short by default; --json gives machine output where it makes sense.

init available

Detects the stack and the agents, writes the profile, plans the files for each agent, shows the plan, asks, writes, records every file and runs the first audit. With no agent found it asks which ones.

npx github:dawidolko/frontend-skills init
Terminal recording: init learns a React and Tailwind project, installs the matching skills for Claude Code, writes the profile and runs the first audit.
init on the example project: the stack it found, the skills and files it planned, the first audit.
Options, as printed by --help
Usage: frontend-skills init [options]

  --agents <ids>     comma-separated: claude, codex, cursor, copilot, gemini, antigravity, devin, opencode, cline, zed, junie, kiro, augment, trae, continue, amazonq, aider (windsurf = devin)
  --format <f>       both (default: skills plus glob-scoped rule files), skills, rules
  --dry-run          show the plan and write nothing
  --yes, -y          write without asking (for scripts)
  --no-audit         skip the first audit

audit available

Checks the source against the rules and writes frontend-report.md. With --url it also checks a running page in your Chrome; with --changed only the files you changed; with --json it prints the condensed output for agents.

npx github:dawidolko/frontend-skills audit
Terminal recording: audit lists findings by severity with rule ids and file:line, and fails at serious.
audit: counts by severity, each rule with its first location, the exit code.
Options, as printed by --help
Usage: frontend-skills audit [path] [options]

  --url <address>     also check a running page (Lighthouse and axe-core in your Chrome; asks before fetching them)
  --changed           only files changed against --base (default HEAD), staged, unstaged or new
  --base <ref>        the git ref for --changed
  --fail-on <level>   critical | serious | moderate | minor | none (default: profile audit.failOn or serious)
  --json              print the condensed JSON for agents instead of the summary
  --report <file>     where to write the Markdown report (default frontend-report.md)
  --no-report         do not write the report
  --yes               fetch the browser tools without asking (with --url)

learn available

Re-detects the stack after it changed, shows the difference and updates the profile and the installed skills. With --lesson it records a lesson you confirmed.

npx github:dawidolko/frontend-skills learn
Options, as printed by --help
Usage: frontend-skills learn [options]

  (no options)          refresh the profile and the installed skills after the stack changed
  --lesson "<text>"     record a confirmed lesson (one line, no secrets)
  --kind <kind>         convention | command | pitfall (with --lesson; default convention)
  --dry-run             show the changes, write nothing
  --yes, -y             apply without asking

list available

Lists the skills that fit this project with their token cost; --all for every skill, --rules for the dictionary.

npx github:dawidolko/frontend-skills list
Options, as printed by --help
Usage: frontend-skills list [--all] [--rules] [--json]

explain available

Prints one rule: title, severity, why, fix, examples, sources and the skill that teaches it. A deprecated id leads to the rule that replaced it.

npx github:dawidolko/frontend-skills explain a11y/img-alt
Terminal recording: explain a11y/img-alt prints the rule, why it matters, the fix, examples and sources.
explain a11y/img-alt: the dictionary entry in the terminal.
Options, as printed by --help
Usage: frontend-skills explain <rule id> [--json]

doctor available

Checks, per agent, which files exist, whether they are current and whether any skill is listed twice. Exits with 1 when something is missing or stale.

npx github:dawidolko/frontend-skills doctor
Options, as printed by --help
Usage: frontend-skills doctor [--json]

update available

Re-installs the recorded selection from the current version. Files you changed are kept and listed.

npx github:dawidolko/frontend-skills update
Options, as printed by --help
Usage: frontend-skills update [--dry-run]

uninstall available

Removes exactly what the install record lists; a file you changed is kept.

npx github:dawidolko/frontend-skills uninstall
Options, as printed by --help
Usage: frontend-skills uninstall [--dry-run] [--yes]

tokens available

Shows the estimated token cost of what is installed: what each agent always loads and what it loads on use.

npx github:dawidolko/frontend-skills tokens
Options, as printed by --help
Usage: frontend-skills tokens [--all] [--json]