Desktop skill

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.

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:

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:

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.