Agent skill

Docs

by AFK-surf in AFK-surf/OpenBridge

“Read, create, and review DOCXs guidance”

— description from SKILL.md by AFK-surf
MITAuto-check passedDocuments & Office

Install Docs

skills CLI
$ npx skills add AFK-surf/OpenBridge --skill docs -a claude-code

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

GitHub CLI
$ gh skill install AFK-surf/OpenBridge docs --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/AFK-surf/OpenBridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/macos/OpenBridge/Resources/SystemSkills.bundle/docs .claude/skills/docs && 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
GitHub stars
430
Token cost
~1.2k tokens
SKILL.md length
551 words
Files
3 (incl. references)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Workflow Decision, Reading DOCXs, Primary tooling for creating… and Quality expectations, plus 2 more sections
  • Runs Python scripts from its folder; calls soffice, pdftoppm and pip

About this skill

Docs is a skill in AFK-surf/OpenBridge (430 stars). Its SKILL.md is about 1.2k tokens, with 2 other files in the folder (references). Licence: MIT.

What it can do on your machine

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

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • soffice
    • pdftoppm
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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 loads about 1.2k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 11 tokens; SKILL.md has 551 words of instructions outside code blocks.

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

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 AFK-surf/OpenBridge at commit a9ca905, republished under its MIT licence (© AFK-surf). 551 words, ~1,211 tokens.

Download SKILL.mdSave it as .claude/skills/docs/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
docs
description
Read, create, and review DOCXs guidance
metadata.displayName
Word Docxs Skill
metadata.icon
doc.text.fill
metadata.color
blue
metadata.placeholder
Upload a document or ask a question

DOCX reading, creation, editing, and review guidance

Workflow Decision

TaskToolReference
Reading/analyzing contentsoffice + pdftoppmSee "Reading DOCXs" below
Creating new documentspython-docxSee "Primary tooling" below
Editing with tracked changesOOXML XML manipulationooxml-editing.md
Adding commentsOOXML XML manipulationooxml-editing.md

Reading DOCXs

  • Use soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX to convert DOCXs to PDFs.
    • The -env:UserInstallation=file:///tmp/lo_profile_$$ flag is important. Otherwise, it will time out.
  • Then Convert the PDF to page images so you can visually inspect the result:
    • pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
  • Then open the PNGs and read the images.
  • Only do python printing as a last resort because you will miss important details with text extraction (e.g. figures, tables, diagrams).

Primary tooling for creating DOCXs

  • Create and edit DOCX files with python-docx. Use it to control structure, styles, tables, and lists. Install it with pip install python-docx if it's not already installed.
  • After every meaningful batch of edits—new sections, layout tweaks, styling changes—render the DOCX to PDF:
    • soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX
  • Convert the PDF to page images so you can visually inspect the result:
    • pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
  • Inspect every PNG before moving on. If you see any defect, fix the DOCX and repeat the render → inspect loop until all pages look perfect.

Quality expectations

  • Aim for a client-ready document: consistent typography, spacing, margins, and layout hierarchy. Heading levels should be obvious, lists aligned, and paragraphs easy to scan.
  • Never ship obvious formatting defects such as clipped or overlapping text, default-template styling, broken tables, unreadable characters, or inconsistent bullet styling.
  • Charts, tables, and visuals must be legible in the rendered PNGs—no pixelation, misalignment, missing labels, or mismatched colors.
  • Never use the U+2011 non-breaking hyphen or other unicode dashes as they will not be rendered correctly. Use ASCII hyphens instead.
  • Citations, references, and footnotes must be human-readable and professional. No tool-internal tokens (e.g., [145036110387964†L158-L160]), malformed URLs, or placeholder text should be present in the document.
  • You must convert all citations into a human-readable format in the document with standard scholarly citation format. No 【【turn1541736113682297662view0†L11-L19】 notations are allowed in the document as the reader cannot interpret them (such citations will be severely penalized).
  • Content should be concise, relevant, and free of boilerplate AI phrasing. Ensure each section adds value and flows logically.
Show full SKILL.md (172 more words)Show less

Final checks

  • Re-run the DOCX → PDF → PNG loop after your final changes and inspect every page at 100% zoom. Look for subtle issues like inconsistent spacing, widows/orphans, or misaligned bullet levels.
  • Correct every formatting defect you see in the PNGs, including but not limited to: overlapping text or shapes, clipped text or shapes that are cut off, black squares, broken tables, unreadable characters, etc.
  • Only deliver the DOCX once the latest PNG review confirms the document is visually flawless and professionally styled.
  • Keep intermediate files organized (or cleaned up) so reviewers can easily locate final outputs.

Advanced: OOXML Editing and Tracked Changes

For editing existing DOCXs with tracked changes (legal/business document review), comments, or raw XML manipulation, read references/ooxml-editing.md.

Key capabilities:

  • Tracked changes (Redlining): Mark insertions with <w:ins> and deletions with <w:del>
  • Comments: Add review comments with <w:commentRangeStart/End>
  • Raw XML access: Direct manipulation of word/document.xml for complex edits

Use this approach when:

  • Editing someone else's document (use redlining)
  • Working with legal, academic, business, or government documents
  • Adding review comments to existing content

© AFK-surf, 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 macos/OpenBridge/Resources/SystemSkills.bundle/docs of AFK-surf/OpenBridge.

  • SKILL.md
  • references/ooxml-editing.md
  • render_docx.py

Open the folder on GitHubat commit a9ca905

Compare with similar skills

Docs 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs this skillAFK-surf/OpenBridge430—~1.2kAutomated safety check: PassMIT
DOCX ToolkitXiaomiMiMo/MiMo-Code14k—~2.4kAutomated safety check: PassApache-2.0
Word DOCX ToolkitNousResearch/hermes-agent252k—~2.6kAutomated safety check: PassMIT
DOCXnexus-research-lab/nexus150—~484Automated safety check: PassApache-2.0
DOCX Creation and Editinganthropics/skills180k6 repos~1.7kAutomated safety check: PassProprietary
Office DOCXsingula-ai/alego1091 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • DOCX Toolkit

    XiaomiMiMo/MiMo-Code

    Produces, edits and reads Microsoft Word files through python-docx and lxml, with a decision table for picking the lightest workflow for a given task.

    14k GitHub stars~2.4k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • Word DOCX Toolkit

    NousResearch/hermes-agent

    Creates, reads, edits and templates Word .docx files with python-docx scripts, including tracked changes, comments, tables of contents and health checks.

    252k GitHub stars~2.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • DOCX

    nexus-research-lab/nexus

    只要 Word 文档或模板(.docx、.dotx、旧版 .doc)是任务的输入或输出,或者需要被打开、 读取、创建、修改,就使用本 Skill。也适用于 Word 内的表格、图片、批注、修订和格式调整, 以及要求以 Word 交付的报告、备忘录、信函和模板。不用于 PDF、电子表格或不涉及 Word 文件的普通写作。

    150 GitHub stars~484 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • DOCX Creation and Editing

    anthropics/skills

    Official

    Creates, edits and reviews Word documents: new files with docx-js, edits through the underlying XML, plus tracked changes, comments and conversions.

    180k GitHub starsUsed in 6 repos~1.7k tokens
    Documents & OfficeAuto-check passed
  • Office DOCX

    singula-ai/alego

    Create, read, edit, and check Word documents (.docx), including reports, letters, and formatted tables.

    109 GitHub starsUsed in 1 repo~1.5k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed

More from AFK-surf/OpenBridge

All 14 skills in this repo
  • Swiftui UI Patterns

    AFK-surf/OpenBridge

    Best practices and example-driven guidance for building SwiftUI views and components.

    430 GitHub starsUsed in 4 repos~887 tokens
    Auto-check passed
  • Swiftui Expert Skill

    AFK-surf/OpenBridge

    Write, review, or improve SwiftUI code following best practices for state management, view composition, performance, modern APIs, Swift concurrency, and iOS 26+ Liquid Glass adoption.

    430 GitHub starsUsed in 2 repos~3.9k tokens
    Auto-check passed
  • UI Designer

    AFK-surf/OpenBridge

    Design or restyle user interfaces using vendored DESIGN.md references from popular product and brand-inspired visual systems.

    430 GitHub stars~4.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Bridge Agent Log Analyzer

    AFK-surf/OpenBridge

    Analyze Bridge agent execution logs from ~/.bridge/sessions, reconstruct the agent's actual runtime behavior, and explain tool execution, failures, retries, and artifacts from persisted session files.

    430 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Format Converter

    AFK-surf/OpenBridge

    Convert files between formats. An agent skill from AFK-surf/OpenBridge.

    430 GitHub stars~549 tokensUpdated 3 mo ago
    Auto-check passed
  • Skill Manager

    AFK-surf/OpenBridge

    Manage skills: create, install, modify, or delete skills. An agent skill from AFK-surf/OpenBridge.

    430 GitHub stars~749 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Docs

How do I install Docs in Claude Code?

Run `npx skills add AFK-surf/OpenBridge --skill docs -a claude-code`. Or copy the skill folder (macos/OpenBridge/Resources/SystemSkills.bundle/docs in AFK-surf/OpenBridge) into .claude/skills/docs in your project. Claude Code loads it when a task matches its description.

How do I install Docs in Codex?

Run `npx skills add AFK-surf/OpenBridge --skill docs -a codex`. Or copy the skill folder (macos/OpenBridge/Resources/SystemSkills.bundle/docs in AFK-surf/OpenBridge) into .agents/skills/docs in your project. Codex loads it when a task matches its description.

Can I use Docs 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 AFK-surf/OpenBridge --skill docs -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, .gemini/skills/docs, .github/skills/docs and .opencode/skills/docs in your project.

What does Docs need to run?

Going by SKILL.md and its folder, Docs needs Python for the scripts in its folder and the command-line tools its instructions call (soffice, pdftoppm and pip).

Does Docs access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Docs 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 use?

Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs use?

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

What are the alternatives to Docs?

Skills that share tags, products or a category with Docs: DOCX Toolkit (XiaomiMiMo/MiMo-Code, 14k stars), Word DOCX Toolkit (NousResearch/hermes-agent, 252k stars), DOCX (nexus-research-lab/nexus, 150 stars) and DOCX Creation and Editing (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs?

AFK-surf (a GitHub organization) maintains it in AFK-surf/OpenBridge, which has 430 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on June 10, 2026.

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