Agent skill

Office Scan Config

by Community-Access in Community-Access/accessibility-agents

Internal helper: manage .a11y-office-config.json scan settings.

MITAuto-check passedFrontend & Design

Install Office Scan Config

skills CLI
$ npx skills add Community-Access/accessibility-agents --skill office-scan-config -a claude-code

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

GitHub CLI
$ gh skill install Community-Access/accessibility-agents office-scan-config --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/Community-Access/accessibility-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/office-scan-config .claude/skills/office-scan-config && 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
office-scan-config
GitHub stars
423
Token cost
~1.4k tokens
SKILL.md length
638 words
Files
3 (incl. references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Internal helper: manage .a11y-office-config.json scan settings.

  • Works in 3 steps: Ask which profile they want (strict,… → Create .a11y-office-config.json in the… → Explain what each setting does
  • Tasks that involve Accessibility
  • SKILL.md covers Your Scope, Configuration File Format, How to Use and Behavioral Rules, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Office Scan Config is an agent skill from Community-Access/accessibility-agents. Internal helper: manage .a11y-office-config.json scan settings.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/complete-rule-reference.md`).

It sits in Frontend & Design, covering Accessibility. It works with Microsoft Word, Microsoft Excel and Microsoft PowerPoint. The repository describes itself as: Accessibility review agents for Claude Code, GitHub Copilot, and Claude Desktop. Eleven specialists that enforce WCAG 2.2 AA compliance so AI coding tools stop generating… The licence is MIT.

When your agent uses it

  • Tasks that involve Accessibility

Example prompts

  • “/office-scan-config”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Ask which profile they want (strict, moderate, minimal) or if they want to customize
  2. Create .a11y-office-config.json in the project root
  3. Explain what each setting does

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. 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 json).

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

  • Network

    No URLs in SKILL.md.

    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

Office Scan Config loads about 1.4k tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 21 tokens; SKILL.md has 638 words of instructions outside code blocks.

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

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

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 638 words, ~1,367 tokens.

Download SKILL.mdSave it as .claude/skills/office-scan-config/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
office-scan-config
description
Internal helper: manage .a11y-office-config.json scan settings.
license
MIT
disable-model-invocation
true
user-invocable
false
metadata.tier
helper
metadata.domain
documents
metadata.output
artifact
metadata.effort
low
metadata.title
Office Scan Config

You are the Office document accessibility scan configuration manager. You help users customize which accessibility rules are enforced when scanning Office documents (.docx, .xlsx, .pptx). You manage .a11y-office-config.json configuration files that the scan_office_document MCP tool reads at scan time.

Your Scope

  • Creating new configuration files with appropriate defaults
  • Explaining what each rule checks and why it matters
  • Enabling or disabling specific rules per file type
  • Managing severity filters (errors, warnings, tips)
  • Providing preset profiles (strict, moderate, minimal)
  • Validating existing configuration files
  • Documenting configuration changes

Configuration File Format

The configuration file is .a11y-office-config.json placed in the project root (or any directory - the scan tool searches upward).

json
{
  "$schema": "https://raw.githubusercontent.com/Community-Access/accessibility-agents/main/schemas/office-scan-config.schema.json",
  "version": "1.0",
  "docx": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning", "tip"]
  },
  "xlsx": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning", "tip"]
  },
  "pptx": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning", "tip"]
  }
}
Fields

Each field, with its type, required and description.

FieldTypeRequiredDescription
versionstringYesConfig format version. Currently "1.0".
docxobjectNoConfiguration for Word document scanning. Omit to use defaults.
xlsxobjectNoConfiguration for Excel workbook scanning. Omit to use defaults.
pptxobjectNoConfiguration for PowerPoint presentation scanning. Omit to use defaults.
*.enabledbooleanNoWhether scanning is enabled for this file type. Default: true.
*.disabledRulesstring[]NoArray of rule IDs to skip during scanning. Default: [].
*.severityFilterstring[]NoWhich severity levels to include: "error", "warning", "tip". Default: all three.

How to Use

Generate a Default Config

When a user asks to "set up office scan config" or "create accessibility config":

  1. Ask which profile they want (strict, moderate, minimal) or if they want to customize
  2. Create .a11y-office-config.json in the project root
  3. Explain what each setting does
Disable a Specific Rule

When a user says "disable the blank characters check" or "turn off DOCX-T003":

  1. Find the rule ID from the reference table
  2. Add it to the disabledRules array for the appropriate file type
  3. Explain what will no longer be checked and why they might want to reconsider
Enable Only Errors

When a user says "only show errors" or "skip warnings and tips":

  1. Set severityFilter to ["error"] for the relevant file type(s)
  2. Warn that warnings often catch real accessibility problems
Disable Scanning for a File Type

When a user says "don't scan Excel files" or "skip pptx":

  1. Set enabled: false for that file type
  2. Confirm the change
Show full SKILL.md (272 more words)Show less
Validate a Config File

When asked to validate:

  1. Read the .a11y-office-config.json file
  2. Check that version is present and is "1.0"
  3. Verify all rule IDs in disabledRules are valid (match known rule patterns)
  4. Verify severityFilter values are valid ("error", "warning", "tip")
  5. Report any unknown rule IDs or invalid values

Behavioral Rules

  1. Always explain impact. When a user disables a rule, explain what it checked and who benefits from it. Never silently disable accessibility checks.
  2. Recommend strict for public documents. Government, education, and public-facing documents should use the strict profile.
  3. Never disable all errors. If a user tries to set severityFilter: [] or disable all error rules, warn that this removes critical accessibility protections.
  4. Suggest gradual adoption. For projects with many existing documents, recommend starting with the minimal profile and progressively enabling more rules.
  5. Document changes. When modifying config, add a comment in the conversation about why the change was made.

Integration

The scan_office_document MCP tool reads this configuration automatically:

  • Pass configPath parameter to specify a custom config location
  • Without configPath, the tool looks for .a11y-office-config.json in the same directory as the scanned file, then searches parent directories
  • Command-line disabledRules and severityFilter parameters override the config file

Reference files

Read one only when the task reaches it. Do not read them all up front.

  • references/complete-rule-reference.md - Complete Rule Reference, Preset Profiles

Output contract

Produce the file or script the task asks for. Report what you wrote as a short list of paths and what each one changes. Do not restate the file contents.

Shared rules, dispatch contract and schemas: skills/a11y-core/SKILL.md. Authoritative specifications for this skill: skills/a11y-core/references/sources.md.

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/office-scan-config of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml
  • references/complete-rule-reference.md

Open the folder on GitHubat commit decf6ba

Compare with similar skills

Office Scan Config 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.

Office Scan Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Office Scan Config this skillCommunity-Access/accessibility-agents423—~1.4kAutomated safety check: PassMIT
OfficeCLI Document EditingSylinko/Everywhere6.3k8 repos~6.3kAutomated safety check: PassCustom licence
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Office File TransformCherryHQ/cherry-studio53k—~4.7kAutomated safety check: PassAGPL-3.0
MinerU Document Readeropendatalab/MinerU81k—~9.4kAutomated safety check: WarnCustom licence
GenOffice Document CLIgenspark-ai/genoffice9.2k—~19kAutomated safety check: PassApache-2.0

Similar skills

  • OfficeCLI Document Editing

    Sylinko/Everywhere

    Creates, reads, proofreads and edits Word, Excel and PowerPoint files through the officecli command line tool, with no Office installation needed.

    6.3k GitHub starsUsed in 8 repos~6.3k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Office File Transform

    CherryHQ/cherry-studio

    Derives new files from a selected part of a spreadsheet, Word document, PDF or slide deck, such as a cell range, paragraph, page or slide, without ever modifying the source file.

    53k GitHub stars~4.7k tokensUpdated today
    Documents & OfficeAuto-check passed
  • MinerU Document Reader

    opendatalab/MinerU

    Reads, OCRs, searches and cites local documents through the mineru CLI, covering PDF, images, Office files, EPUB, HTML and CSV.

    81k GitHub stars~9.4k tokensUpdated today
    Documents & OfficeAuto-check: warnings
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    9.2k GitHub stars~19k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Docx4j

    plutext/docx4j

    A skill your agent uses when writing Java code that creates, reads or edits Word (.docx), PowerPoint (.pptx) or Excel (.xlsx) files with docx4j — including generating documents, editing existing…

    2.4k GitHub stars~2.5k tokensUpdated today
    Documents & OfficeAuto-check passed

More from Community-Access/accessibility-agents

All 108 skills in this repo
  • A11y Core

    Community-Access/accessibility-agents

    Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules.

    423 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed
  • Kb Web Scanning

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed
  • Accessibility Lead

    Community-Access/accessibility-agents

    Web UI accessibility lead. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~932 tokensUpdated 17 days ago
    Auto-check passed
  • Alt Text Headings

    Community-Access/accessibility-agents

    Alt text, SVGs, figures, charts, heading order, page titles and landmarks.

    423 GitHub stars~1.5k tokensUpdated 17 days ago
    Auto-check passed
  • Aria Specialist

    Community-Access/accessibility-agents

    ARIA roles, states and properties for custom widgets and dynamic content.

    423 GitHub stars~1.6k tokensUpdated 17 days ago
    Auto-check passed
  • Cognitive Accessibility

    Community-Access/accessibility-agents

    Plain language, WCAG 2.2 cognitive criteria, COGA guidance and auth UX.

    423 GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed

Questions about Office Scan Config

What does Office Scan Config do?

Internal helper: manage .a11y-office-config.json scan settings. Office Scan Config is an agent skill from Community-Access/accessibility-agents.json scan settings.

When should I use Office Scan Config?

Office Scan Config fits situations like: tasks that involve Accessibility.

How do I install Office Scan Config in Claude Code?

Run `npx skills add Community-Access/accessibility-agents --skill office-scan-config -a claude-code`. Or copy the skill folder (skills/office-scan-config in Community-Access/accessibility-agents) into .claude/skills/office-scan-config in your project. Claude Code loads it when a task matches its description.

How do I install Office Scan Config in Codex?

Run `npx skills add Community-Access/accessibility-agents --skill office-scan-config -a codex`. Or copy the skill folder (skills/office-scan-config in Community-Access/accessibility-agents) into .agents/skills/office-scan-config in your project. Codex loads it when a task matches its description.

Can I use Office Scan Config 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 Community-Access/accessibility-agents --skill office-scan-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/office-scan-config, .gemini/skills/office-scan-config, .github/skills/office-scan-config and .opencode/skills/office-scan-config in your project.

What does Office Scan Config need to run?

SKILL.md names no scripts, command-line tools or credentials: Office Scan Config is instructions for the agent only.

Does Office Scan Config access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Office Scan Config 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 Office Scan Config use?

Office Scan Config is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Office Scan Config use?

About 1.4k tokens (SKILL.md is roughly 5.5k 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 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Office Scan Config?

Skills that share tags, products or a category with Office Scan Config: OfficeCLI Document Editing (Sylinko/Everywhere, 6.3k stars), Markitdown (ImCa0/just-laws, 781 stars), Office File Transform (CherryHQ/cherry-studio, 53k stars) and MinerU Document Reader (opendatalab/MinerU, 81k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Office Scan Config?

Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 423 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on September 23, 2026.

Source: Community-Access/accessibility-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.