How to use the Foldyn desktop Skill
22 October 2026
1. What it is
The Foldyn Skill runs on your own Mac, inside Claude Code or Cursor. It settles a paid Skill run: it holds one credit, then keeps that charge only when the checks below pass.
The public repository does not include Foldyn’s print-production programs, and it does not build a delivery package by itself. The delivery-package check reads a result file already on the Mac.
This Skill runs only as a local desktop tool on that Mac, inside Claude Code or Cursor. It does not run in Claude.ai Cloud, and it does not run in Cursor cloud agents.
2. What you need
Hard gate
These have to be on the machine. If the print-design app is missing, the run stops and does not charge you.
- macOS.
- Adobe Illustrator on the same Mac. Without it,
doctorfails. The credit script holds one credit and then releases it, so the run is not charged.
Separate image products
Upscale ($1.99) and Generate + upscale ($3.99) are separate products on the pricing page. They are not included in a Skill run, and a Skill run does not spend those credits.
Python
The credit script needs Python 3.11 or newer and no extra packages. Before a run, this command has to pass:
python scripts/foldyn_credit.py doctor
3. Buy access
Skill prices are on the pricing page, in the Skill block:
- Per run — $5.99
- Monthly · 10 runs — $29.99
After purchase, the receipt email for the checkout address includes a one-time link to view your API token, these install commands, and the public repository address. The link works for 24 hours and shows the token once. The email does not attach a Skill package. If the email does not arrive, write to hello@foldyn.co.uk.
The repository is github.com/foldyn/foldyn-skill.
4. Install on a Mac (Claude Code or Cursor)
Claude Code
mkdir -p ~/.claude/skills && git clone https://github.com/foldyn/foldyn-skill.git ~/.claude/skills/foldyn-skill
Cursor
mkdir -p ~/.cursor/skills && git clone https://github.com/foldyn/foldyn-skill.git ~/.cursor/skills/foldyn-skill
Save the token from the claim link as FOLDYN_BILLING_TOKEN, or as the token field in ~/.cache/foldyn/billing.json with "url": "https://billing.foldyn.co.uk". The environment variable wins when both are set. Do not commit the token.
Then run doctor again and continue only when it passes:
python scripts/foldyn_credit.py doctor
5. How a run is charged
From the installed skill folder, a chargeable run is:
python scripts/foldyn_credit.py doctor
python scripts/foldyn_credit.py lock /path/to/job
python scripts/foldyn_credit.py settle /path/to/job
settle holds one credit first. It confirms that hold only when all three checks pass:
- Print-design app.
doctorpasses. If Illustrator is missing, the hold is released and you are not charged. - Delivery package.
work/release_check.jsonin the job directory has"verdict": "可交付". This page does not claim the installed skill creates that file. - Locked artwork. You have confirmed the artwork.
lockonly records that confirmation. It does not spend a credit. Do not lock artwork you have not confirmed.
If any check fails, settle releases the hold and that credit is not used. A Skill monthly plan is used before a single-run credit. The service checks the token, the idempotency key, and the balance. Changing the installed script does not bypass those checks.
A confirmed run does not include a free revision. Another confirmed run is another credit.
6. Billing reminder
Prices are listed on the pricing page and may change. Check that page before you buy. Legal pages do not hard-code amounts.
The legal pages are:
7. Help
Email hello@foldyn.co.uk.