Fix a Portwood merge-tag or parser bug correctly across all of its resolution paths.
$ npx skills add Portwood-Global-Solutions/Portwood --skill fix-merge-tag -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood fix-merge-tag --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/fix-merge-tag .claude/skills/fix-merge-tag && 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 "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .claude/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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/fix-merge-tagType 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 fix-merge-tag -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood fix-merge-tag --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/fix-merge-tag .agents/skills/fix-merge-tag && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .agents/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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 fix-merge-tag -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood fix-merge-tag --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/fix-merge-tag .cursor/skills/fix-merge-tag && 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 "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .cursor/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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/fix-merge-tag--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 fix-merge-tag -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Portwood-Global-Solutions/Portwood fix-merge-tag --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/fix-merge-tag .gemini/skills/fix-merge-tag && 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 "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .gemini/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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 fix-merge-tagInstalls 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 fix-merge-tag -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/fix-merge-tag .github/skills/fix-merge-tag && 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 "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .github/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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 fix-merge-tag -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 fix-merge-tag --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/fix-merge-tag .opencode/skills/fix-merge-tag && 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 "fix-merge-tag" agent skill from https://github.com/Portwood-Global-Solutions/Portwood/tree/main/.claude/skills/fix-merge-tag into .opencode/skills/fix-merge-tag/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "fix-merge-tag", 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.
fix-merge-tagFix a Portwood merge-tag or parser bug correctly across all of its resolution paths.
Fix Merge Tag is an agent skill from Portwood-Global-Solutions/Portwood. Fix a Portwood merge-tag or parser bug correctly across all of its resolution paths. Use when changing tag parsing, section/loop tags, conditionals, aggregates, or chart buckets — a fix in one path silently does not reach the others.
Its SKILL.md is about 1.4k 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. It works with 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.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 70ede0c. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
npmFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Fix Merge Tag loads about 1.4k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 570 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.
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.
The full file from Portwood-Global-Solutions/Portwood at commit 70ede0c, republished under its Apache-2.0 licence (© Portwood-Global-Solutions). 570 words, ~1,367 tokens.
.claude/skills/fix-merge-tag/SKILL.md (or your agent's skills folder).The trap: there is more than one place that resolves tags, and they do not share code. A fix landed in one path leaves the others broken, and the failure is silent — the tag just prints raw or evaluates wrong for templates that happen to take a different route.
Before writing a fix, work out which path(s) the reported template takes.
DocGenGiantQueryAssembler does not call processXml(). So:
| Path | Resolved by | Reached when |
|---|---|---|
| Row-level loop bodies | DocGenService.processXml() | normal templates |
| Parent-level tags outside the loop | DocGenGiantQueryAssembler.resolveParentMergeTags() | giant-query templates (>2000 child rows) |
| Grand-total aggregates | DocGenGiantQueryAssembler.resolveGiantAggregateTags() | giant-query templates |
A section-tag fix in processXml covers only row-level loop bodies. If the change
needs to behave consistently for giant-query templates, mirror it in the assembler or
route it through processXmlForTest the same way format-suffix tags already do.
Always check whether your fix needs the same change in the giant-query parent path,
and add an e2e-07 assertion either way — including one that proves it doesn't need it.
{#ChartBucket} resolution paths{#ChartBucket:relationship:field[:mod=val&...]}body{/ChartBucket} has its own set,
and all four must stay consistent:
DocGenChartBucketResolver.preprocessInline against pre-loaded
relationship records. Used when child count <2000 and no where=/groupBy=.
SOQL-free, fastest.tryFallbackSoqlAggregateAdvanced, when the relationship isn't
on the data map or where=/groupBy= force it. Schema-auto-discovers child object
and FK via ChildRelationship, issues a GROUP BY aggregate at constant cost.
This is how 30K-scale templates work.resolveParentMergeTags()'s regex skips {#…} prefixes so charts
pass through, then processXmlForTest routes to the inline path.resolveGiantChartBuckets for charts targeting the giant
relationship. Same modifiers, same shape.SOQL budget: 50 chart aggregates per transaction
(DocGenChartBucketResolver.chartSoqlBudget). When exhausted, charts render a sentinel
"Chart limit reached" bucket — never silently empty.
Composable, and all four paths must honour each:
| Modifier | Behavior |
|---|---|
colors=#aaa,#bbb | Override the default 8-color palette, cycling by row index |
where=Field='X' AND Y != null | Sanitized SOQL fragment appended to the WHERE. Forces SOQL fallback. |
split=; | Multi-select delimiter; percentages summing >100% is expected |
groupBy=Field__c | Cross-tab pivot; each row gets a cols sub-list. Forces SOQL fallback. |
colSort=v1,v2 | Column ordering for groupBy=; named first, rest alpha, Total last |
V1 (flat string) and V3 (node tree) reproduce similar patterns in different code —
V3's processChildNodes and V1's stitchGrandchildren. A fix often needs to land in
both.
For PDF output, {%ImageField} tags with ContentVersion IDs skip blob loading.
currentOutputFormat is set to 'PDF' before processXml() calls; in
buildImageXml(), when the format is 'PDF' and the value is a 068 ID, query only
Id, FileExtension — never VersionData — and store the relative URL
/sfc/servlet.shepherd/version/download/<cvId>.
If your fix touches processXml:
VersionData to the PDF-path SOQL.URL.getOrgDomainUrl() anywhere in the image pipeline.Image URLs for Blob.toPdf must be relative. Absolute URLs and data: URIs render
broken.
processXml's try/catch must rethrow HeapPressureException ahead of the generic
catch. Order: HeapPressureException → DocGen* → generic.
e2e-07-syntax5 (or a new syntax6) exercising the
pattern via processXmlForTest. syntax1–syntax4 are near the 18,000-char ceiling.e2e-07 assertion for the giant-query parent path — even if the answer is
"unchanged", the assertion is what stops the next person breaking it.npm run qa -- --suite merge-tagsnpm run format:check.See the run-tests skill for the constraints on writing e2e assertions.
© 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
Just SKILL.md in .claude/skills/fix-merge-tag of Portwood-Global-Solutions/Portwood.
Open the folder on GitHubat commit 70ede0c
Fix Merge Tag 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 |
|---|---|---|---|---|---|---|
| Fix Merge Tag this skillPortwood-Global-Solutions/Portwood | 126 | — | ~1.4k | Automated safety check: Pass | Apache-2.0 | |
| Automation Sandbox Post Copy Config Generateforcedotcom/sf-skills | 1.1k | — | ~4.1k | Automated safety check: Pass | Apache-2.0 | |
| Automation Sandbox Post Copy Config Generateforcedotcom/sf-skills | 1.1k | — | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Education Cloud Academic Calendar Generateforcedotcom/sf-skills | 1.1k | — | ~4.4k | Automated safety check: Pass | Apache-2.0 | |
| Implementing Zero Trust For SaaS Applicationsmukul975/Anthropic-Cybersecurity-Skills | 34k | — | ~2.9k | Automated safety check: Pass | Apache-2.0 | |
| Education Cloud Course Catalog Migrateforcedotcom/sf-skills | 1.1k | — | ~5.4k | Automated safety check: Pass | Apache-2.0 |
forcedotcom/sf-skills
Generate the JSON config file that the Salesforce sandbox post-copy automation tool consumes, from a customer SOP in any format (PDF, xlsx, csv, JSON, docx, Markdown, plain text, or a screenshot of…
forcedotcom/sf-skills
Generate the JSON config file that the Salesforce sandbox post-copy automation tool consumes, from a customer SOP in any format (PDF, xlsx, csv, JSON, docx, Markdown, plain text, or a screenshot of…
forcedotcom/sf-skills
A skill your agent uses to set up, create, or generate an academic calendar for Education Cloud orgs.
mukul975/Anthropic-Cybersecurity-Skills
Secures SaaS apps (Microsoft 365, Google Workspace, Salesforce, Slack) via CASB/SSPM deployment, conditional access policies, OAuth app governance, and session-level DLP controls enforcing identity…
forcedotcom/sf-skills
A skill your agent uses to migrate course catalog data from external sources (CSV, PDF, website) and bulk-create Learning and LearningCourse records in Education Cloud.
forcedotcom/sf-skills
Analyzes DevOps Center test failures and Code Analyzer violations in plain language — failure category, offending file/class/method/line, rule violated, fix direction, and prioritized improvement…
Portwood-Global-Solutions/Portwood
Work on Portwood's Canvas designer (docGenCanvas LWC and canvasModel.js).
Portwood-Global-Solutions/Portwood
Get from a fresh clone of Portwood to a working, fully-tested Salesforce org.
Portwood-Global-Solutions/Portwood
Author or repair a Portwood HTML template that renders correctly through Blob.toPdf (Flying Saucer).
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.
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.
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.
Works with
Categories
Fix a Portwood merge-tag or parser bug correctly across all of its resolution paths. Fix Merge Tag is an agent skill from Portwood-Global-Solutions/Portwood. Fix a Portwood merge-tag or parser bug correctly across all of its resolution paths.
Fix Merge Tag fits situations like: changing tag parsing; section/loop tags; chart buckets — a fix in one path silently does not reach the others.
Run `npx skills add Portwood-Global-Solutions/Portwood --skill fix-merge-tag -a claude-code`. Or copy the skill folder (.claude/skills/fix-merge-tag in Portwood-Global-Solutions/Portwood) into .claude/skills/fix-merge-tag in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Portwood-Global-Solutions/Portwood --skill fix-merge-tag -a codex`. Or copy the skill folder (.claude/skills/fix-merge-tag in Portwood-Global-Solutions/Portwood) into .agents/skills/fix-merge-tag in your project. Codex loads it when a task matches its description.
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 fix-merge-tag -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fix-merge-tag, .gemini/skills/fix-merge-tag, .github/skills/fix-merge-tag and .opencode/skills/fix-merge-tag in your project.
Going by SKILL.md and its folder, Fix Merge Tag needs the command-line tools its instructions call (npm).
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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.
Fix Merge Tag 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.
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.
Skills that share tags, products or a category with Fix Merge Tag: Automation Sandbox Post Copy Config Generate (forcedotcom/sf-skills, 1.1k stars), Automation Sandbox Post Copy Config Generate (forcedotcom/sf-skills, 1.1k stars), Education Cloud Academic Calendar Generate (forcedotcom/sf-skills, 1.1k stars) and Implementing Zero Trust For SaaS Applications (mukul975/Anthropic-Cybersecurity-Skills, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
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.
