https://github.com/stevysmith/stacktree-skill
https://github.com/stevysmith/stacktree-skill
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/stevysmith/stacktree-skill
- Owner: stevysmith
- License: mit
- Created: 2026-05-11T09:35:05.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-12T00:20:28.000Z (2 months ago)
- Last Synced: 2026-05-12T02:29:36.548Z (2 months ago)
- Language: Shell
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# stacktree-publish
The official [Stacktree](https://stacktr.ee) skill for Claude Code, Cursor, OpenCode, Codex, and any other agent that speaks the [Anthropic Skills](https://code.claude.com/docs/en/skills) format.
When the user asks to "publish this", "share this page", or "drop this on stacktree", the agent pipes the HTML artifact to `stacktr.ee` and returns the private URL back into the conversation.
## Install
```bash
npx skills@latest add stevysmith/stacktree-skill
```
This drops `SKILL.md` and `scripts/publish.sh` into your agent's skill directory (`~/.claude/skills/` for Claude Code, `~/.codex/skills/` for Codex, etc.).
## Configure
Generate an API key at [app.stacktr.ee/api-keys](https://app.stacktr.ee/api-keys), then export it:
```bash
export STACKTREE_API_KEY=stk_live_...
```
For shell-restart persistence, add the line to `~/.zshrc` or `~/.bashrc`.
## What the agent gets
The skill exposes one shell script — `publish.sh` — that the agent invokes when it has an HTML artifact ready to share. Supported flags:
| Flag | Purpose |
|---|---|
| `--password ` | Basic-auth gate |
| `--expires-in-hours ` | Set expiry in hours |
| `--expires-never` | Disable expiry |
| `--burn-after-read` | Delete on first view |
| `--agentation` | Inject the on-page feedback toolbar |
| `--public-slug ` | Opt into a public `{slug}.stacktr.ee` URL |
| `--update ` | Replace an existing site in place |
| `--pii-check off\|warn\|block` | PII scanner mode (default: `warn`) |
## Privacy posture
- **Unguessable URLs by default** — every upload gets a 22-char token; not crawlable, not enumerable.
- **`X-Robots-Tag: noai, noimageai`** on every served response.
- **Auto-expire** — anon uploads vanish in 24h; authed uploads default to never expire.
- **PII pre-flight scan** — emails, SSNs, credit cards, common API-key prefixes are flagged before publish.
Full feature set:
## License
MIT