docs
JimLiu/open-artifactOffice & PDFWriting & contentFrontend & design
docs is a skill in JimLiu/open-artifact, last changed 20 Nov 2026. It can run shell commands.
Make and revise a living doc in the Docs format as a local folder: doc/doc.json names the doc, its tabs and its dropdown lists, and each tab is a tree of blocks (headings, paragraphs, lists and checklists, tables, code, quotes, pictures) whose characters carry ids, with chips for dates, @-mentions, links to tabs and dropdowns. This skill's script creates the doc (from markdown or a skeleton), imports a Markdown, Word (.docx) or PDF file as a new doc or a new tab, reads it, edits it in place block by block or as suggestions the person accepts or rejects, and exports it as Markdown, Word, PDF or HTML; a local page shows it where people type, comment, react and look back through each tab's versions, shared on the local network by link when asked. Use when someone asks for a document, report, plan, proposal, brief, memo, spec, handbook, guide or meeting notes to keep, share, comment on or revise together (even one they will send as Word or PDF), names the Docs type, or wants to change a folder that holds doc/doc.json. Not for a static HTML page, changing a Word file (.docx) they already have as Word, a slide deck, or an answer read once in chat.
At a glance
Pattern check
Nothing flagged
That isn't proof the skill is harmless.
Commit 35c6a8c · 20 Nov 2026
How the check worksPattern check: nothing flagged
That isn't proof the skill is harmless.
QAI Index
We rate every listed skill the same way, from 0 to 100.
A guide to compare by, not a verdict on the skill.
How it's scoredGet an email when its check changes.
Keep it with the other skills you use, installed with one command.
Install
Sign in to see how to install it
Free with Google or an email link, no password needed. Then pick your agent and copy its steps.
What it can touch
Sign in to see the file and line behind each one
The summary at the top stays open to everyone. Signing in is free, with Google or an email link.
Pattern check
Pattern check: nothing flagged · commit 35c6a8c · 20 Nov 2026
We checked every text file in this skill, at commit 35c6a8c on 20 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specFails
The format our Agent Skills docs set out, held to the strictest version of each rule among the agents we check.
- Error
The description is 1,159 characters; the limit is 1,024. D2
Fix: Shorten it to 1,024 characters or fewer, and move detail into the body.
- Warning
The body is about 8,402 tokens (approx.); the spec suggests under 5,000. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
The first sentence of the description is 328 characters. Agents shorten long descriptions, so lead with the main job. D8
Fix: Start with one short sentence that names the job.
- Note
There is no license field, so readers can't tell whether they may reuse the skill. O2
Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.
- Error
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
The first sentence of the description is 328 characters. Agents shorten long descriptions, so lead with the main job. D8
Fix: Start with one short sentence that names the job.
- Note
The body is about 8,402 tokens (approx.); the spec suggests under 5,000. After compaction Claude Code keeps only the first 5,000 tokens of a skill. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
Claude apps & API uploadFails
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Error
The description is 1,159 characters; the limit is 1,024. Anthropic's validator rejects it. D2
Fix: Shorten it to 1,024 characters or fewer, and move detail into the body.
- Note
The body is about 8,402 tokens (approx.); the spec suggests under 5,000. Anthropic's guidance says the same. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Error
OpenAI (Codex & API)Fails
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Error
The description is 1,159 characters; the limit is 1,024. Codex has no limit, but OpenAI's upload follows the spec. D2
Fix: Shorten it to 1,024 characters or fewer, and move detail into the body.
- Note
The first sentence of the description is 328 characters. Agents shorten long descriptions, so lead with the main job. D8
Fix: Start with one short sentence that names the job.
- Error
VS Code & CopilotPasses with warnings
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Warning
The description is 1,159 characters; the limit is 1,024. VS Code cuts it at 1,024 characters. D2
Fix: Shorten it to 1,024 characters or fewer, and move detail into the body.
- Warning
SKILL.md
Files
Changelog
Newest first: each commit that changed its folder on GitHub, and each change to its listing here.
- Updated: Docs: Ask Agent as a comment in the text, find inside chips, and stea… (9ff4ec0 (opens in a new tab))
- Listed on QAI
- Updated: Update artifact editors and collaboration workflows (d297a34 (opens in a new tab))
- Updated: Add Docs as a built-in artifact type (ceabe71 (opens in a new tab))
QAI Index badge
Show this skill's QAI Index in a README or on a website. It links back to this page and changes when we refresh the catalog.
[](https://qai.io/skills/jimliu/open-artifact/docs)More from JimLiu/open-artifact
Other Office & PDF skills
Same category, most repo stars first.