🧪 Stacktree Skill
Publish HTML artifacts to stacktr.ee and get back a private URL you can paste into the conversation. Use when the user asks to "publish this", "share this page", "drop this on stacktree", or whenever
About Stacktree Skill
Do not use this for code that isn't a complete static page (e.g. fragments, JSX components without a host page). Wrap the fragment in a minimal HTML shell first.
At 742 words, this medium prompt gives your agent specialized testing & qa expertise with structured patterns and output formats. Copy it into CLAUDE.md, .cursorrules, or Copilot instructions.
Key Capabilities
- User asks to publish, share, host, or drop an HTML / Markdown artifact you just generated.
- User wants a link to a hosted version of a page they just saw (e.g. a dashboard, mock, table).
- You just produced an HTML artifact and the user will benefit from a browser view.
- Unlisted URL (`stacktr.ee/p/<22-char-token>/`) — not enumerable
- 7-day expiry — the artifact auto-deletes unless you pass `--expires-never`
What This Skill Covers
- When to invoke
- Required env
- Privacy-first defaults
- Steps
- Examples
- Privacy
How It Works
- Give the agent x402 payment ability (any x402 client, e.g. `@x402/fetch`,
- `POST https://api.stacktr.ee/provision` returns a `402`; the x402 client
- Optionally buy upgrades the same way: `POST /unlock?feature=custom_domain`
- `POST https://api.stacktr.ee/pay/sessions` with `{ "feature": "provision" }`
- The JSON response includes a `qr` field that is a ready-to-print terminal
Use Cases
- Writing unit, integration, and end-to-end tests
- Setting up test coverage and CI pipelines
- Refactoring legacy code with confidence using tests
- Creating test plans and QA checklists
Example Prompts
System Prompt (742 words)
stacktree-publish
Publish an HTML artifact to stacktr.ee and return the URL into the conversation.
When to invoke
- User asks to publish, share, host, or drop an HTML / Markdown artifact you just generated.
- User wants a link to a hosted version of a page they just saw (e.g. a dashboard, mock, table).
- You just produced an HTML artifact and the user will benefit from a browser view.
Required env
STACKTREE_API_KEY=stk_live_... # generate at https://app.stacktr.ee/api-keys
STACKTREE_API_URL=https://api.stacktr.ee # optional overrideIf STACKTREE_API_KEY isn't set, ask the user to set it before retrying.
No key, and no human to make one? Pay for one (x402)
A fully autonomous agent with a funded wallet can provision its own key over
x402, no human and no dashboard:
- Give the agent x402 payment ability (any x402 client, e.g.
@x402/fetch,
POST https://api.stacktr.ee/provisionreturns a402; the x402 client
stk_live_ key. Set it as STACKTREE_API_KEY and continue.
- Optionally buy upgrades the same way:
POST /unlock?feature=custom_domain
higher_limits). See <https://stacktr.ee/x402> for the full flow.Only do this when there is genuinely no human to set a key; otherwise the
dashboard key is simpler.
No wallet, but your human is at the terminal? Show a pay QR
The fastest path when a paid action comes up mid-task (provision, make a
site permanent, custom domain, higher limits):
POST https://api.stacktr.ee/pay/sessionswith{ "feature": "provision" }
{ "feature": "custom_domain" } etc. with the API key.
- The JSON response includes a
qrfield that is a ready-to-print terminal
url. Print both and say what it costs (the amount
field) and why.
- The human scans with their phone and pays by card (Stripe, ~two taps).
- Poll the
poll.urlevery few seconds; onprovisionthe poll returns the
STACKTREE_API_KEY), on unlocks it confirms the
feature is active. Continue the task without further prompting.
- Prefer one scan over many: pass
"amount_minor": 1000onprovision(or
{ "feature": "topup", "amount_minor": 1000 } later). Anything above
the action's price becomes a prepaid balance, and future paid actions draw
from it silently — no more QRs until it runs out.Privacy-first defaults
Every publish via this skill applies tighter defaults than the raw API:
- Unlisted URL (
stacktr.ee/p/<22-char-token>/) — not enumerable - 7-day expiry — the artifact auto-deletes unless you pass
--expires-never - PII scan in block mode — emails, SSNs, credit cards, API key prefixes (
sk-,xoxb-,ghp_, AWSAKIA) reject the publish; pass--pii-check warnto override - Strict CSP +
X-Robots-Tag: noai, noimageaion every served page
Steps
- Make sure the artifact is a complete HTML document (
<!doctype html>...</html>). If you only have a body fragment or markdown, wrap it. - Run
scripts/publish.sh(in this skill's directory) with the artifact piped on stdin. Pass options via flags:
--password <secret> — basic-auth gate
- --expires-in-hours <n> or --expires-never
- --burn-after-read
- --agentation — enables the on-page feedback toolbar
- --public-slug <slug> — opt into {slug}.stacktr.ee/
- --pii-check off|warn|block — defaults to block via this skill (warn at the API)
- The script prints a JSON object including
url. Surface the URL inline in your reply, plus expiry and any PII warnings.
Examples
Publish a quick artifact:
echo "$ARTIFACT_HTML" | bash scripts/publish.sh
# → { "url": "https://stacktr.ee/p/AbC.../", "expires_at": 1781234567, ... }Publish with password + 7-day expiry:
echo "$ARTIFACT_HTML" | bash scripts/publish.sh --password hunter2 --expires-in-hours 168Replace an existing site (preserves the URL):
echo "$ARTIFACT_HTML" | bash scripts/publish.sh --update <id-or-slug>Privacy
By default every URL is unlisted (stacktr.ee/p/{22-char-token}/) and not crawlable. Anonymous uploads expire in 24h. Authed (API-key) uploads default to never expire. Pass --public-slug only when the user wants a discoverable URL.
If the artifact contains values that look like API keys, emails, SSNs, or credit cards, the response includes X-Stacktree-Pii-Warning. Surface this to the user before sending the link to anyone.
Frequently Asked Questions
What is Stacktree Skill?
Stacktree Skill is a free testing & qa skill for AI coding agents. Publish HTML artifacts to stacktr.ee and get back a private URL you can paste into the conversation. Use when the user asks to "publish this", "share this page", "drop this on stacktree", or whenever . It provides a specialized system prompt that configures your agent with testing & qa expertise.
How do I use Stacktree Skill with Claude Code?
Copy the system prompt below and paste it into your CLAUDE.md file or Claude Code's custom instructions to activate Stacktree Skill.
Which AI coding agents work with Stacktree Skill?
Stacktree Skill is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Stacktree Skill free to use?
Yes, Stacktree Skill is completely free and open source. The full source is available on GitHub at https://github.com/stevysmith/stacktree-skill/blob/main/SKILL.md. You only need a subscription to the AI agent you use it with.
