Agent skill

Document Generation

by automateyournetwork in automateyournetwork/netclaw

Generate Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication.

Apache-2.0Auto-check passedDocuments & Office

Install Document Generation

skills CLI
$ npx skills add automateyournetwork/netclaw --skill document-generation -a claude-code

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

GitHub CLI
$ gh skill install automateyournetwork/netclaw document-generation --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/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/document-generation .claude/skills/document-generation && 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
document-generation
GitHub stars
674
Token cost
~1.9k tokens
SKILL.md length
977 words
Files
1
Skills in repo
218
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication.

  • Works in 5 steps: Never fill a gap with a guess. Send… → Never send a value without src. It will… → Call pdf_inspect_form before… → …
  • Tasks that involve PowerPoint presentations
  • SKILL.md covers MCP Server, The one rule that matters most, Tagged values — the only… and Tools (6), plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Document Generation is an agent skill from automateyournetwork/netclaw. Generate Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication. This is the generic document-writing engine (tool surface, tagged-value shapes, fabrication rules). For the four standard NetClaw report compositions (change record, audit workbook, executive summary deck, PDF form) with their content-sourcing rules, use network-report-documents instead — it is built on this skill. Use this skill directly for…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering PowerPoint presentations, Excel spreadsheets and PDF. It works with Microsoft Excel, Microsoft PowerPoint, Microsoft Word and Model Context Protocol. The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve PowerPoint presentations
  • Tasks that involve Excel spreadsheets
  • Tasks that involve PDF

Example prompts

  • “/document-generation”

Workflow steps

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

  1. Never fill a gap with a guess. Send unavailable or failed with a real reason.
  2. Never send a value without src. It will be refused, and it should be.
  3. Call pdf_inspect_form before pdf_fill_form so you map data to fields that actually exist.
  4. Report what the response says. If it came back written_with_gaps, tell the operator the document is
  5. Give the operator the path. They need to find the file.

What it can do on your machine

Read from SKILL.md and the folder at commit 95bb17e. 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 jsonc).

    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

Document Generation loads about 1.9k tokens when it runs. Until then it costs about 142 tokens; SKILL.md has 977 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~142
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

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 automateyournetwork/netclaw at commit 95bb17e, republished under its Apache-2.0 licence (© automateyournetwork). 977 words, ~1,912 tokens.

Download SKILL.mdSave it as .claude/skills/document-generation/SKILL.md (or your agent's skills folder).
name
document-generation
description
Generate Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication. This is the generic document-writing engine (tool surface, tagged-value shapes, fabrication rules). For the four standard NetClaw report compositions (change record, audit workbook, executive summary deck, PDF form) with their content-sourcing rules, use `network-report-documents` instead — it is built on this skill. Use this skill directly for any other one-off deliverable.
version
1.0.0
license
Apache-2.0
tags
documents, docx, xlsx, pptx, pdf, reporting, change-record, audit, deliverables
user-invocable
true

Document Generation

MCP Server

  • Server: document-mcp (NetClaw-authored, spec 082 / roadmap R18)
  • Command: $DOCUMENT_MCP_CMD
  • Transport: stdio
  • Credentials: none. This server writes files and touches nothing else
  • Infrastructure: no device access, no ticket writes — so there is no approval gate here

The one rule that matters most

A document must never fabricate to fill a blank.

Tool output is ephemeral — read once, in context, by the person who asked. A document is not. It gets emailed, attached to a ticket, filed for audit, and read months later by someone who was not there, and it carries the authority of its formatting.

A professional-looking change record with a plausible invented number is a far more effective way to launder a guess into an official record than any amount of terminal output, because nobody re-derives a figure that is already in a table in a .docx.

So: never infer, estimate, interpolate, or carry forward a stale value to complete a document. If you do not have a figure, send {"unavailable": "<why>"}. The server renders that as visible text. It will not render a blank, and it will not let you send one.

Tagged values — the only accepted shape

Every value in a figure, table, keyvalue or form field is one of exactly three shapes:

jsonc
{"v": "fgt-01", "src": "fgt_system_status", "device": "fgt-01", "as_of": "2026-08-03T13:58:00Z"}
{"unavailable": "device did not answer within timeout"}
{"failed": "FortiGate plane unreachable: connection refused"}
You sendThe document shows
{"v": x, "src": ...}x, with a visible source
{"v": ""}(empty) — the source was consulted and returned nothing
{"unavailable": r}NOT AVAILABLE — r
{"failed": r}RETRIEVAL FAILED — r
{"v": x} with no srcrefused
a bare xrefused

unavailable and failed are different facts and render differently: a dead query is not an empty result. Neither ever renders as N/A, 0, -, or an empty cell.

Tools (6)

ToolDoes
docx_writeWord document from ordered blocks: heading, paragraph, figure, table, keyvalue, image, pagebreak
xlsx_writeWorkbook from sheets of tagged rows, plus failed_rows
pptx_writeDeck from slides: bullets, figure, image
pdf_inspect_formList a PDF's real named fields — call this before filling
pdf_fill_formFill named fields into a new file; reports unfilled and unmatched
list_documentsFind something you generated earlier

What the server adds that you cannot omit

  • A Source column on every table and every spreadsheet row — appended by the writer.
  • An As of column carrying the source's own collection time, distinct from the generation time.
  • Generation time and NetClaw attribution in the .docx footer on every page, the .xlsx banner, and the .pptx title and Sources slides.
  • A Sources section in every file, listing each tool with its as-of and whether it was ok, partial or failed.
  • A GAIT record for every call, including refusals.

If any figure lacks a source, the whole call is refused. There is no partial path.

Three limits, stated up front

No footnotes in Word. python-docx has no footnote API, so attribution is inline — a Source column in tables, a small parenthetical after prose figures. That is more visible than a footnote, not less. Word comments and document properties are set additively but never count as provenance: they are collapsed by default, stripped on paste, and absent in print.

No Office templates. .docx, .xlsx and .pptx are built from scratch and a supplied template is refused, not ignored — otherwise you would get an unbranded document believing it was branded. A corporate template's empty field is the strongest fabrication pressure in the feature. PDF forms are the exception because their fields are explicitly named: there is nothing to guess.

A filled PDF carries no Sources section. It is the customer's form and adding a page would alter it. For that one format provenance lives in the tool response and the GAIT record. Say so when you hand the file over.

Show full SKILL.md (370 more words)Show less

Put figures in the right block

Prose carries no attribution. A paragraph asserting a bare number gets a caveat naming the block index — use figure, table or keyvalue instead, all of which force a source. Dates, ticket numbers, IPs, versions and "Section 2" are not flagged.

Other behaviour worth knowing

  • Admin state and operational state must be separate columns. A merged status column is refused. An interface can be administratively up with no carrier, and collapsing them tells a reader traffic is passing when nothing is.
  • Sources that disagree are both shown, with their origins and a caveat. NetClaw does not pick a winner.
  • Untrusted text cannot become a formula. A description beginning with = is written as literal text — openpyxl would otherwise turn it into a live formula in an auditor's spreadsheet.
  • Files are never overwritten. Output is timestamped and exclusively created, so a regenerated report cannot replace one already attached to a ticket. Path is reported back.
  • ok means complete. A document with any gap comes back as written_with_gaps, and you cannot override that.

Boundaries — which skill owns what

Want to…Use
Draw a diagramdrawio-diagram, markmap-viz, uml-diagram, threejs-network-viz. This embeds their output and never redraws it — pass the file they produced plus src naming them
Read a document into the knowledge baserag-mcp (feature 062). It reads these formats; this writes them. Same libraries, opposite direction
Create or update a change recordservicenow-change-workflow owns the CR lifecycle. This renders a document from one and never writes a ticket
Send the document somewhereslack-report-delivery, webex-report-delivery. Writing a file is in scope here; sending it is not
Compose a NetClaw-shaped reportnetwork-report-documents — the four standard compositions

Important rules

  1. Never fill a gap with a guess. Send unavailable or failed with a real reason.
  2. Never send a value without src. It will be refused, and it should be.
  3. Call pdf_inspect_form before pdf_fill_form so you map data to fields that actually exist.
  4. Report what the response says. If it came back written_with_gaps, tell the operator the document is incomplete and which parts. Handing over a gapped document as if it were finished undoes the whole point.
  5. Give the operator the path. They need to find the file.

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

Files

Just SKILL.md in workspace/skills/document-generation of automateyournetwork/netclaw.

Open the folder on GitHubat commit 95bb17e

Compare with similar skills

Document Generation 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.

Document Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Document Generation this skillautomateyournetwork/netclaw674—~1.9kAutomated safety check: PassApache-2.0
Nutrient Document Processingaffaan-m/ECC274k4 repos~1.5kAutomated safety check: PassMIT
Nutrient Document Processingaffaan-m/ECC274k3 repos~1.3kAutomated safety check: PassMIT
Nutrient Document Processingaffaan-m/ECC274k2 repos~1.3kAutomated safety check: PassMIT
Doc SummarizerBlackBeltTechnology/pi-agent-dashboard316—~1.2kAutomated safety check: PassMIT
Nutrient Document Processingxu-xiang/everything-claude-code-zh2k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Process, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API.

    274k GitHub starsUsed in 4 repos~1.5k tokens
    Documents & OfficeAuto-check passed
  • 使用Nutrient DWS API处理、转换、OCR识别、提取、编辑、签名和填写文档。支持PDF、DOCX、XLSX、PPTX、HTML和图像格式。

    274k GitHub starsUsed in 3 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Nutrient DWS API を使用してドキュメントの処理、変換、OCR、抽出、編集、署名、フォーム入力を行います。PDF、DOCX、XLSX、PPTX、HTML、画像に対応しています。

    274k GitHub starsUsed in 2 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Doc Summarizer

    BlackBeltTechnology/pi-agent-dashboard

    Summarize documents of any size: extract with the document-converter engine, chunk to fit context, fan out to subagents, then synthesize one unified summary.

    316 GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Nutrient Document Processing

    xu-xiang/everything-claude-code-zh

    使用 Nutrient DWS API 进行文档处理、转换、OCR、提取、脱敏、签名以及表单填充。支持 PDF、DOCX、XLSX、PPTX、HTML 和图像格式。

    2k GitHub stars~1.3k tokensUpdated 7 mo ago
    Documents & OfficeAuto-check passed
  • Nutrient Document Processing

    xu-xiang/everything-claude-code-zh

    使用 Nutrient DWS API 处理、转换、OCR、提取、脱敏、签名和填充文档。支持 PDF、DOCX、XLSX、PPTX、HTML 和图像。

    2k GitHub stars~1.3k tokensUpdated 7 mo ago
    Documents & OfficeAuto-check passed

More from automateyournetwork/netclaw

All 218 skills in this repo
  • EVE-NG Lab Topology Design

    automateyournetwork/netclaw

    Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.

    674 GitHub stars~612 tokensUpdated yesterday
    Auto-check passed
  • ACI Policy Change Deployment

    automateyournetwork/netclaw

    Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.

    674 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Cisco ACI Fabric Health Audit

    automateyournetwork/netclaw

    Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.

    674 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Anta Validation

    automateyournetwork/netclaw

    Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.

    674 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Arista Cvp

    automateyournetwork/netclaw

    Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).

    674 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check: notes
  • AWS Cloud Monitoring

    automateyournetwork/netclaw

    AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.

    674 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Questions about Document Generation

What does Document Generation do?

Generate Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication. Document Generation is an agent skill from automateyournetwork/netclaw.pptx) documents and fill existing PDF forms, from real NetClaw data, with per-element provenance and no fabrication.

When should I use Document Generation?

Document Generation fits situations like: tasks that involve PowerPoint presentations; tasks that involve Excel spreadsheets; tasks that involve PDF.

How do I install Document Generation in Claude Code?

Run `npx skills add automateyournetwork/netclaw --skill document-generation -a claude-code`. Or copy the skill folder (workspace/skills/document-generation in automateyournetwork/netclaw) into .claude/skills/document-generation in your project. Claude Code loads it when a task matches its description.

How do I install Document Generation in Codex?

Run `npx skills add automateyournetwork/netclaw --skill document-generation -a codex`. Or copy the skill folder (workspace/skills/document-generation in automateyournetwork/netclaw) into .agents/skills/document-generation in your project. Codex loads it when a task matches its description.

Can I use Document Generation 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 automateyournetwork/netclaw --skill document-generation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/document-generation, .gemini/skills/document-generation, .github/skills/document-generation and .opencode/skills/document-generation in your project.

What does Document Generation need to run?

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

Does Document Generation 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 Document Generation 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 Document Generation use?

Document Generation is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Document Generation use?

About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Document Generation?

Skills that share tags, products or a category with Document Generation: Nutrient Document Processing (affaan-m/ECC, 274k stars), Nutrient Document Processing (affaan-m/ECC, 274k stars), Nutrient Document Processing (affaan-m/ECC, 274k stars) and Doc Summarizer (BlackBeltTechnology/pi-agent-dashboard, 316 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Document Generation?

automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 674 GitHub stars. The repository holds 218 skills in this directory. The repository was last updated on October 5, 2026.

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