菜单
Set up a local share server for coding-agent HTML/static artifacts, or connect portable share skills to an existing compatible server. Use when the user wants local browser-share infrastructure, Tailscale-backed viewing, or reusable artifact publishing across coding agents.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Survey a repo and ground externally on the relevant parts of the internet. Local manifest scan + CLAUDE.md/AGENTS.md + recent git activity, then external grounding via WebSearch, WebFetch, and gh — synthesized into a terse, dated, sourced briefing cached at docs/ground/<fingerprint>.md with a 7-day freshness window. Composable: invoked standalone or embedded as a pre-flight phase in other skills. Triggers: ground, ground yourself, ground myself, survey and ground, pre-flight grounding, research the stack, what's new in.
Collaborative discovery before planning. Explore the problem space, evaluate approaches, surface past work, and produce a structured brainstorm document. Triggers: brainstorm, explore, discovery, ideate, think through, what should we build, explore approaches.
Strategic planning with auto-calibrated detail, decision rationale, and dependency ordering. Use when starting a new feature, bug fix, refactor, or any non-trivial work. Produces a plan document with tasks, reasoning, and acceptance criteria. Triggers: plan, planning, create plan, implementation plan, feature plan, work plan.
Execute a plan from start to ship — read tasks, implement in dependency order, test continuously, commit incrementally, run quality checks, and push. The plan's checkboxes are the tracker. Triggers: work, execute plan, implement, start work, build, ship, finalize, release, push, ready to ship, done building.
Capture a footgun the agent just hit (or the user just spotted) as a proposed trigger via `quellis teach`. Guided flow: gather the finding, run the CLI, surface the proposed trigger, leave activation to the user. Triggers: teach quellis, capture this footgun, add a trigger, remember this rule.
Review and manage evidence contracts in this repo. Subcommands: `show` (default, print the active contract), `list` (all contracts + which is active), `complete` (mark active contract completed), `abandon` (mark active contract abandoned). Triggers: contract, show contract, list contracts, mark contract complete, what's active.
| name | share-server-setup |
| description | Set up a local share server for coding-agent HTML/static artifacts, or connect portable share skills to an existing compatible server. Use when the user wants local browser-share infrastructure, Tailscale-backed viewing, or reusable artifact publishing across coding agents. |
| compatibility | Requires Bun, curl, and optionally Tailscale CLI for private tailnet exposure. macOS LaunchAgent automation is supported in v1. |
Set up or adopt a local share server for cross-agent HTML/static artifact sharing.
share-html cannot run because the share server is not configured yetThis skill may:
~/.agent-share/config.jsontailscale serve for the viewer listenerThis skill may not:
bash scripts/healthcheck.sh
bash scripts/install-reference-server.sh
bash scripts/install-launch-agent.sh
bash scripts/configure-tailscale-viewer.sh --public-base-url "https://<machine>.<tailnet>.ts.net"
If the user already has a compatible local share server, write the config without reinstalling:
bash scripts/configure-existing-server.sh \
--api-url "http://127.0.0.1:4815" \
--viewer-url "http://127.0.0.1:4816" \
--public-base-url "https://<machine>.<tailnet>.ts.net" \
--provider existing
Then verify:
bash scripts/healthcheck.sh
Install the reference server files, initialize config, and verify health:
bash scripts/install-reference-server.sh
bash scripts/healthcheck.sh
On macOS, set up long-running mode:
bash scripts/install-launch-agent.sh
Tailscale is optional.
If used, expose only the viewer listener. The publish/admin API remains localhost-only.
This skill's Tailscale helper configures:
127.0.0.1:4816tailscale serve --bg 4816publicBaseUrlscripts/healthcheck.sh — check config and GET /healthscripts/install-reference-server.sh — install the reference server and initialize configscripts/install-launch-agent.sh — configure macOS LaunchAgent persistencescripts/configure-existing-server.sh — point config at an already-running compatible serverscripts/configure-tailscale-viewer.sh — expose viewer listener over tailscale serve and update configdocs/setup.mddocs/existing-server.mddocs/troubleshooting.md