Agent skill

Docs Style Lint

by AvaloniaUI in AvaloniaUI/avalonia-docs

Reviews and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing standards, accessibility, and SEO.

No licenceAuto-check passedDevelopment

Install Docs Style Lint

skills CLI
$ npx skills add AvaloniaUI/avalonia-docs --skill docs-style-lint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AvaloniaUI/avalonia-docs docs-style-lint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AvaloniaUI/avalonia-docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/docs-style-lint .claude/skills/docs-style-lint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-style-lint
GitHub stars
166
Token cost
~4.6k tokens
SKILL.md length
1,988 words
Files
5 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Reviews and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing standards, accessibility, and SEO.

  • Works in 10 steps: Identify page type → Run structural checks → Run anti-marketing checks → …
  • Writing documentation to ensure consistency with established patterns
  • SKILL.md covers Diataxis as invisible discipline, Technical accuracy…, When to use and Inputs, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Docs Style Lint is an agent skill from AvaloniaUI/avalonia-docs. Reviews and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing standards, accessibility, and SEO. Use when reviewing, editing, or writing documentation to ensure consistency with established patterns. Checks structure, voice, terminology, formatting, linking, tone, Diataxis compliance, image accessibility, meta descriptions, and jargon simplification.

Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/house-rules.yaml`, `references/linter-checklist.md` and `references/page-templates.yaml`).

It sits in Development, covering Linting and formatting, Plain language and style rules and On-page SEO. It works with Avalonia.

When your agent uses it

  • Writing documentation to ensure consistency with established patterns
  • Tasks that involve Linting and formatting
  • Tasks that involve Plain language and style rules

Example prompts

  • “Use the docs-style-lint skill to review and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing…”
  • “/docs-style-lint”

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Identify page type
  2. Run structural checks
  3. Run anti-marketing checks
  4. Run terminology checks
  5. Validate API references (ACCU-003)
  6. Run content boundary checks
  7. Run template compliance
  8. Check banned phrases
  9. Run inclusive language checks
  10. Generate report

What it can do on your machine

Read from SKILL.md and the folder at commit 0d91508. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.avaloniaui.net

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs Style Lint loads about 4.6k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 1,988 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~4.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~18k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,988 words (~4,605 tokens).

“Review documentation pages against Avalonia's house style rules derived from corpus analysis of professional .NET framework documentation, adapted for Avalonia's Docusaurus-based site.”

— opening of SKILL.md by AvaloniaUI
name
docs-style-lint

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in .claude/skills/docs-style-lint of AvaloniaUI/avalonia-docs.

  • SKILL.md
  • references/house-rules.yaml
  • references/linter-checklist.md
  • references/page-templates.yaml
  • references/terminology-map.yaml

Open the folder on GitHubat commit 0d91508

Compare with similar skills

Docs Style Lint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs Style Lint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Style Lint this skillAvaloniaUI/avalonia-docs166—~4.6kAutomated safety check: PassNone
Md Reviewborghei/Claude-Skills886—~3.8kAutomated safety check: PassMIT
Commenting C And Pythonmicrosoft/bocpy201—~3.3kAutomated safety check: PassMIT
Code Review And QualityHangYu8123/mini-harness199—~1.8kAutomated safety check: PassNone
Code Quality Reviewrsmdt/the-startup557—~525Automated safety check: PassMIT
Code Layout Evaluation Principleskitchen-engineer42/pdf2skills134—~383Automated safety check: PassNone

Similar skills

  • Md Review

    borghei/Claude-Skills

    Pre-publication quality gate for authored Markdown — heading structure, on-disk link resolution, readability, accessibility, terminology.

    886 GitHub stars~3.8k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Official

    Follow bocpy commenting and documentation conventions. An agent skill from microsoft/bocpy.

    201 GitHub stars~3.3k tokensUpdated 11 days ago
    DevelopmentAuto-check passed
  • Code Review And Quality

    HangYu8123/mini-harness

    Multi-axis, review-only code review of a diff across six axes — request achievement, correctness, readability/simplicity, architecture, security, and performance — with severity-labelled findings.

    199 GitHub stars~1.8k tokensUpdated 16 days ago
    DevelopmentAuto-check passed
  • Code Quality Review

    rsmdt/the-startup

    Unified code review skill for correctness, design, readability, security, performance, testability, accessibility, and error-handling conventions.

    557 GitHub stars~525 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Code Layout Evaluation Principles

    kitchen-engineer42/pdf2skills

    Evaluate code layout quality based on accuracy, consistency, readability, and maintainability rather than aesthetics.

    134 GitHub stars~383 tokensUpdated 7 mo ago
    DevelopmentAuto-check passed
  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed

More from AvaloniaUI/avalonia-docs

  • Docusaurus Styling

    AvaloniaUI/avalonia-docs

    Style Docusaurus sites to match Avalonia Customer Portal theme using TailwindCSS, CSS variables, and component swizzling.

    166 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • API Link Builder

    AvaloniaUI/avalonia-docs

    Scans the /docs directory for opportunities to cross-link with API reference documentation in /api, and vice versa.

    166 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Discussion Gap Finder

    AvaloniaUI/avalonia-docs

    Analyzes GitHub discussion links to identify documentation gaps.

    166 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Tailwind To Infima

    AvaloniaUI/avalonia-docs

    You are an expert in Docusaurus theming and the Infima CSS framework.

    166 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Questions about Docs Style Lint

What does Docs Style Lint do?

Reviews and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing standards, accessibility, and SEO. Docs Style Lint is an agent skill from AvaloniaUI/avalonia-docs. Reviews and lints Avalonia documentation pages against house style rules, content boundaries, anti-marketing standards, accessibility, and SEO.

When should I use Docs Style Lint?

Docs Style Lint fits situations like: writing documentation to ensure consistency with established patterns; tasks that involve Linting and formatting; tasks that involve Plain language and style rules.

How do I install Docs Style Lint in Claude Code?

Run `npx skills add AvaloniaUI/avalonia-docs --skill docs-style-lint -a claude-code`. Or copy the skill folder (.claude/skills/docs-style-lint in AvaloniaUI/avalonia-docs) into .claude/skills/docs-style-lint in your project. Claude Code loads it when a task matches its description.

How do I install Docs Style Lint in Codex?

Run `npx skills add AvaloniaUI/avalonia-docs --skill docs-style-lint -a codex`. Or copy the skill folder (.claude/skills/docs-style-lint in AvaloniaUI/avalonia-docs) into .agents/skills/docs-style-lint in your project. Codex loads it when a task matches its description.

Can I use Docs Style Lint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AvaloniaUI/avalonia-docs --skill docs-style-lint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-style-lint, .gemini/skills/docs-style-lint, .github/skills/docs-style-lint and .opencode/skills/docs-style-lint in your project.

What does Docs Style Lint need to run?

SKILL.md names no scripts, command-line tools or credentials: Docs Style Lint is instructions for the agent only.

Does Docs Style Lint access the network?

SKILL.md names 1 domain. As links in the text: docs.avaloniaui.net. This is read from the text; nothing was executed.

Is Docs Style Lint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Docs Style Lint use?

No licence was found for Docs Style Lint or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Docs Style Lint use?

About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 14k tokens, read only when the agent opens those files.

What are the alternatives to Docs Style Lint?

Skills that share tags, products or a category with Docs Style Lint: Md Review (borghei/Claude-Skills, 886 stars), Commenting C And Python (microsoft/bocpy, 201 stars), Code Review And Quality (HangYu8123/mini-harness, 199 stars) and Code Quality Review (rsmdt/the-startup, 557 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Style Lint?

AvaloniaUI (a GitHub organization) maintains it in AvaloniaUI/avalonia-docs, which has 166 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.

Source: AvaloniaUI/avalonia-docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.