Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written.
Install Triage Report
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood triage-report --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/triage-report .claude/skills/triage-report && rm -rf skills-srcUse ~/.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/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .claude/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-reportType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood triage-report --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/triage-report .agents/skills/triage-report && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .agents/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood triage-report --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/triage-report .cursor/skills/triage-report && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .cursor/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Portwood-Global-Solutions/Portwood.git --path .claude/skills/triage-report--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood triage-report --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/triage-report .gemini/skills/triage-report && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .gemini/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Portwood-Global-Solutions/Portwood triage-reportInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/triage-report .github/skills/triage-report && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .github/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood triage-report --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Portwood-Global-Solutions/Portwood.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/triage-report .opencode/skills/triage-report && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "triage-report" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/triage-report into .opencode/skills/triage-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "triage-report", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
triage-report- GitHub stars
- 126
- Token cost
- ~1.5k tokens
- SKILL.md length
- 801 words
- Files
- 1
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written.
- Works in 4 steps: Reproduce it → Rule out the template → If it survives, it's a bug: record it → …
- A user reports the PDF looks wrong
- SKILL.md covers Step 1 — Reproduce it, Step 2 — Rule out the template, Step 3 — If it survives, it's… and Step 4 — Is it a showstopper?, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Triage Report is an agent skill from Portwood-Global-Solutions/Portwood. Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written. Use when a user reports "the PDF looks wrong", a merge tag didn't resolve, an image is missing, a chart is distorted, or output doesn't match the template. Most reports are template issues.
Its SKILL.md is about 1.5k 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 PDF and QA and bug reports. It works with Microsoft Word and Salesforce. The repository describes itself as: Free, native document generation for Salesforce. PDF, DOCX, XLSX, PPTX — merge tags, images, barcodes, QR codes, bulk generation, Flow actions. 100% Apex + LWC, zero external… The licence is Apache-2.0.
When your agent uses it
- A user reports the PDF looks wrong
- A merge tag didnt resolve
- An image is missing
- A chart is distorted
Example prompts
- “the PDF looks wrong”
- “t resolve, an image is missing, a chart is distorted, or output doesn”
- “/triage-report”
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 70ede0c. 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 bash).
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
Triage Report loads about 1.5k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 801 words of instructions outside code blocks.
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 Portwood-Global-Solutions/Portwood at commit 70ede0c, republished under its Apache-2.0 licence (© Portwood-Global-Solutions). 801 words, ~1,549 tokens.
Download SKILL.mdSave it as
.claude/skills/triage-report/SKILL.md (or your agent's skills folder).- name
- triage-report
- description
- Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written. Use when a user reports "the PDF looks wrong", a merge tag didn't resolve, an image is missing, a chart is distorted, or output doesn't match the template. Most reports are template issues.
Triaging a Portwood report
Most reports are template issues, not code defects. Work through this before
calling anything a bug. A report that turns out to be an authoring problem gets
answered as guidance and closed with the template-help label — it does not become
engineering work.
Step 1 — Reproduce it
Do not skip to a diagnosis from the description. Get the template, the record, and the output format. If you can't reproduce, ask for the template body and the generated file before anything else.
The single most useful question to ask a reporter: "Is the template HTML or DOCX?" It splits the decision tree in half.
Step 2 — Rule out the template
These account for the majority of "it looks wrong" reports.
CSS 3 in an HTML template
The PDF engine is Blob.toPdf → Flying Saucer, which is CSS 2.1 plus a small
CSS 3 subset. These are silently ignored — the page renders, but layout collapses
to default block flow:
display: flex,display: grid,gaplinear-gradient(...)and other gradient functionscalc(...)- CSS custom properties / variables
- most CSS 3 layout features
Grep the template body first:
grep -nE "display:\s*(flex|grid)|gap:|linear-gradient|calc\(|var\(--" template.htmlAny hit → template issue. The fix is <table>-based layout and solid colors.
The tbody selector trap
table > tbody > tr > td silently matches nothing, because the parser's tree doesn't
have the implied <tbody> the browser inserts. Use td attributes or class-only
selectors instead. A stylesheet that "does nothing" usually has one of these.
A chart style the output format can't render
Charts work in Word, PowerPoint, Excel, PDF and HTML — but not every style works in every format, and the mismatch is silent. Check the style against the format before calling it a bug:
| Style | Word / PPTX / XLSX | HTML → PDF | HTML in a browser |
|---|---|---|---|
bar | ✅ PNG | ✅ CSS-bar | ✅ |
pivot | ❌ | ✅ CSS table | ✅ |
clustered, stacked | ✅ PNG | ✅ CSS table | ✅ |
column, pie, donut, line, area | ✅ PNG | ❌ needs SVG | ✅ with htmlRender=svg |
Two rules explain the whole table:
- Word / PowerPoint / Excel get a rasterized PNG from
DocGenChartRasterizer. ItsKNOWN_STYLESarebar, column, pie, donut, stacked, clustered, line, area—pivotis not among them, because a cross-tab is a table, not a chart shape. - HTML → PDF renders CSS-bar tables.
htmlRender=svgproduces inline<svg>, and Flying Saucer drops inline SVG fromBlob.toPdf— it renders in a browser and vanishes in the PDF. Socolumn/pie/donut/line/areaneed a non-PDF HTML target, or a different style.
"My pie chart is blank in the PDF" is the classic report, and it's a format/style mismatch, not a defect.
Reference templates in docs/: SurveyChartExample.html is canonical,
CommuteSurveyExample.html composes pivot + filter + multi-select + colSort,
SurveyChartExample.docx is the Word-authored variant.
Images that never appear
Image URLs for Blob.toPdf must be relative. Absolute URLs and data: URIs both
render broken. If the template has https://... or data:image/... in an <img src>,
that's the answer.
Fields that "don't exist"
No such column on a field that plainly exists in the org almost always means the
permission set was not assigned, or was assigned before the deploy. Assign
DocGen_Admin after deploying, then retry.
Show full SKILL.md (306 more words)Show less
A {#ChartBucket} pivot duplicating whole rows
Placing {#cols} directly inside a <tr> makes each column duplicate the entire row —
the HTML container auto-expansion looks for the nearest open <tr>. Use
<div class="row"> + display: table-row. Canonical pattern in
docs/CommuteSurveyExample.html.
Step 3 — If it survives, it's a bug: record it
Do not fix it. File the issue. The issue is the deliverable — it is the work queue that community contributors pick from, so the write-up carries the weight a direct fix used to.
A good Portwood issue has:
- Exact repro — template shape, record shape, output format, what you expected.
file:linecitations into the actual code.- The mechanism proven, not asserted. Run the code and paste the real output. A one-liner that demonstrates the failure beats a paragraph describing it.
- Ranked fix options, with a recommendation and why.
- An explicit scope note — which code paths reach this, and which don't.
Label it: bug, a priority:*, a severity:* if output is silently wrong, plus the
area label (designer, pdf, docx, bulk-generation, flow-action). Add
good first issue when the fix is well-bounded and you've named the option to take —
those are what a new contributor can actually land.
See issues #282 and #295 for the reference shape.
Step 4 — Is it a showstopper?
Only P0 breaks the batching pattern and gets fixed immediately.
The P0 test: would a customer hit this and not know their output is wrong? If yes, it's P0 regardless of how rare. Silent corruption beats loud crashes. Data loss and "package unusable for a whole customer segment" also qualify.
Everything else waits for a designated fix session. See TRIAGE.md for the full
rubric.
The four merge-tag resolution paths
If the report is a merge-tag bug, find out which path it took before diagnosing —
a fix in one path does not reach the others. See the fix-merge-tag skill.
© Portwood-Global-Solutions, 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 .claude/skills/triage-report of Portwood-Global-Solutions/Portwood.
Open the folder on GitHubat commit 70ede0c
Compare with similar skills
Triage Report 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Triage Report this skillPortwood-Global-Solutions/Portwood | 126 | — | ~1.5k | Automated safety check: Pass | Apache-2.0 | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Gzh Designisjiamu/gzh-design-skill | 4k | — | ~2.2k | Automated safety check: Pass | AGPL-3.0 | |
| GenOffice Document CLIgenspark-ai/genoffice | 9.2k | — | ~19k | Automated safety check: Pass | Apache-2.0 | |
| Translate Bookdeusyu/translate-book | 2.1k | — | ~5.5k | Automated safety check: Notes | MIT | |
| Docsagentdocsagent/docsagent | 625 | — | ~834 | Automated safety check: Pass | None |
Similar skills
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
GenOffice Document CLI
genspark-ai/genoffice
Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.
Translate Book
deusyu/translate-book
Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents.
Docsagent
docsagent/docsagent
Search and manage private, local document collections (PDF, PPTX, DOCX) offline.
PDF
zai-org/ZCode
Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.
More from Portwood-Global-Solutions/Portwood
Canvas Designer
Portwood-Global-Solutions/Portwood
Work on Portwood's Canvas designer (docGenCanvas LWC and canvasModel.js).
Dev Setup
Portwood-Global-Solutions/Portwood
Get from a fresh clone of Portwood to a working, fully-tested Salesforce org.
HTML Template Authoring
Portwood-Global-Solutions/Portwood
Author or repair a Portwood HTML template that renders correctly through Blob.toPdf (Flying Saucer).
Fix Merge Tag
Portwood-Global-Solutions/Portwood
Fix a Portwood merge-tag or parser bug correctly across all of its resolution paths.
Managed Package Rules
Portwood-Global-Solutions/Portwood
Constraints that only bite in a real managed-package install of Portwood — global visibility, Flow Apex-Defined types, namespace-prefixed keys, USERMODE on internal reads, immutable API names.
Run Tests
Portwood-Global-Solutions/Portwood
Run Portwood's test suites — the one-command QA harness, the anonymous-Apex e2e scripts, Apex unit tests, prettier, and Code Analyzer.
Related
Works with
Categories
Questions about Triage Report
What does Triage Report do?
Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written. Triage Report is an agent skill from Portwood-Global-Solutions/Portwood. Decide whether a Portwood bug report is a real code defect or a template-authoring problem, before any code is written.
When should I use Triage Report?
Triage Report fits situations like: A user reports the PDF looks wrong; A merge tag didnt resolve; an image is missing; A chart is distorted.
How do I install Triage Report in Claude Code?
Run `npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a claude-code`. Or copy the skill folder (.claude/skills/triage-report in Portwood-Global-Solutions/Portwood) into .claude/skills/triage-report in your project. Claude Code loads it when a task matches its description.
How do I install Triage Report in Codex?
Run `npx skills add Portwood-Global-Solutions/Portwood --skill triage-report -a codex`. Or copy the skill folder (.claude/skills/triage-report in Portwood-Global-Solutions/Portwood) into .agents/skills/triage-report in your project. Codex loads it when a task matches its description.
Can I use Triage Report 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 Portwood-Global-Solutions/Portwood --skill triage-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/triage-report, .gemini/skills/triage-report, .github/skills/triage-report and .opencode/skills/triage-report in your project.
What does Triage Report need to run?
SKILL.md names no scripts, command-line tools or credentials: Triage Report is instructions for the agent only.
Does Triage Report 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 Triage Report 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 Triage Report use?
Triage Report is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Triage Report use?
About 1.5k tokens (SKILL.md is roughly 6.2k 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 Triage Report?
Skills that share tags, products or a category with Triage Report: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 4k stars), GenOffice Document CLI (genspark-ai/genoffice, 9.2k stars) and Translate Book (deusyu/translate-book, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Triage Report?
Portwood-Global-Solutions (a GitHub organization) maintains it in Portwood-Global-Solutions/Portwood, which has 126 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 9, 2026.
Source: Portwood-Global-Solutions/Portwood on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.