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 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 auditaudit 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 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 askinglist 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 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]