Skip to content
contextlint

Quick Start — AI-assisted

If you use an AI host that supports agentskills.io, the Skill route is the shortest path. Three steps and you’re running lint.

1. Install the Skill

Section titled “1. Install the Skill”
Terminal window
gh skill install nozomi-koborinai/contextlint contextlint-init

The contextlint-init Skill is registered as an available skill on your AI host. You can install contextlint-fix and contextlint-impact the same way, but contextlint-init alone is enough to start.

2. Ask the AI to set things up

Section titled “2. Ask the AI to set things up”

Open your AI host inside the current repository and ask:

Set up contextlint.

The AI invokes the contextlint-init Skill and runs through the following:

  1. Detects where documents live in the repository (not just docs/, but also specs/, adr/, decisions/, etc.)
  2. Infers the document style (ADR format / spec format / table-heavy / heavy placeholder use, and so on)
  3. Proposes a rule set that fits the project
  4. After confirmation, installs @contextlint/cli and writes contextlint.config.json

You don’t need to pick rules by hand from the catalog of 21.

3. Run lint

Section titled “3. Run lint”

Once the config is written, the AI runs lint for the first time and shows the result. If violations appear, you can follow up by asking the contextlint-fix Skill to suggest fixes.

If you’d rather run it yourself, the following command produces the same output.

Terminal window
npx contextlint

That completes the AI-assisted setup.

Supported AI hosts

Section titled “Supported AI hosts”
  • Claude Code
  • Cursor Agent
  • Cline
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Other hosts that follow the agentskills.io spec

Next steps

Section titled “Next steps”