Agent skill

Sharehtml Collaboration

by jonesphillip in jonesphillip/sharehtml

A skill your agent uses when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI.

Apache-2.0Auto-check passed

Install Sharehtml Collaboration

skills CLI
$ npx skills add jonesphillip/sharehtml --skill sharehtml-collaboration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jonesphillip/sharehtml sharehtml-collaboration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jonesphillip/sharehtml.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sharehtml-collaboration .claude/skills/sharehtml-collaboration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sharehtml-collaboration
GitHub stars
132
Token cost
~902 tokens
SKILL.md length
475 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI.

  • Works in 4 steps: Verify the file is a supported format. → Run sharehtml deploy . → If the CLI indicates the document… → …
  • A user wants to deploy
  • SKILL.md covers When to use, Default behavior, Workflows and Key commands, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sharehtml Collaboration is an agent skill from jonesphillip/sharehtml. Use when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI. This skill covers safe deploy workflows, reviewing unresolved comments, finding documents by name with sharehtml list, and presenting diffs in human language before overwriting. Keep documents private by default and only make them shareable if the user explicitly asks.

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Cloudflare, Cloudflare Durable Objects and Cloudflare Workers. The repository describes itself as: Deploy HTML, Markdown, and code files from the CLI. Get a shareable URL with live comments, reactions, and presence. Self-hosted on Cloudflare Workers. The licence is Apache-2.0.

When your agent uses it

  • A user wants to deploy
  • Review feedback on documents managed with the sharehtml CLI

Example prompts

  • “/sharehtml-collaboration”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Verify the file is a supported format.
  2. Run sharehtml deploy .
  3. If the CLI indicates the document already exists and would be updated
  4. Only make the document shareable if the user explicitly asks.

What it can do on your machine

Read from SKILL.md and the folder at commit 27ddaaf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sharehtml Collaboration loads about 902 tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 475 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~902

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jonesphillip/sharehtml at commit 27ddaaf, republished under its Apache-2.0 licence (© jonesphillip). 475 words, ~902 tokens.

Download SKILL.mdSave it as .claude/skills/sharehtml-collaboration/SKILL.md (or your agent's skills folder).
name
sharehtml-collaboration
description
Use when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI. This skill covers safe deploy workflows, reviewing unresolved comments, finding documents by name with `sharehtml list`, and presenting diffs in human language before overwriting. Keep documents private by default and only make them shareable if the user explicitly asks.

When to use

Use this skill whenever the task involves a document managed with sharehtml, including:

  • deploying or updating a local document
  • sharing or unsharing a document
  • pulling a remote document locally
  • comparing local changes against the deployed document
  • reviewing unresolved comments and addressing feedback

sharehtml can deploy supported source files directly, including .html, .md, .markdown, .json, and common code files such as .js, .ts, .jsx, .tsx, .py, .rb, .go, .rs, .java, .c, .cpp, .css, and .sh.

Do not wrap code or Markdown in HTML unless the user explicitly asks for that. If the file is binary or not a supported text/source format, do not try to deploy it directly.

Default behavior

  • Keep documents private by default.
  • Never run sharehtml share ... unless the user explicitly asks to make a document shareable.
  • If a deploy would overwrite an existing document, do not blindly confirm it.
  • Before overwriting, run sharehtml diff <file>, summarize the changes in plain language, and ask the user to confirm.
  • When a command needs a document id and the user only knows the document name, use sharehtml list to find candidates. If multiple matches are plausible, ask the user to choose.

Workflows

Deploy or update a document
  1. Verify the file is a supported format.
  2. Run sharehtml deploy <file>.
  3. If the CLI indicates the document already exists and would be updated:
    • run sharehtml diff <file>
    • summarize the proposed changes in human language
    • ask the user whether to proceed with the overwrite
  4. Only make the document shareable if the user explicitly asks.
Show full SKILL.md (219 more words)Show less
Review and address feedback
  1. Resolve the document id or URL.
    • If only a name is given, use sharehtml list.
  2. Run sharehtml comments <id> --json.
  3. Pull the document locally if needed with sharehtml pull <id>.
  4. Make the requested local changes.
  5. Run sharehtml diff <file>.
  6. Summarize the changes in human language and ask for approval before deploying.
  7. Run sharehtml deploy <file> once approved.

Key commands

  • sharehtml deploy <file> -- deploy or update a local document
  • sharehtml diff <file> -- compare local content against the deployed document
  • sharehtml pull <id> -- download the remote file
  • sharehtml comments <id> -- read unresolved comments (--json for machine-readable output)
  • sharehtml list -- find documents by title or filename
  • sharehtml open <id> -- open a document in the browser
  • sharehtml share <document> -- make a document shareable
  • sharehtml unshare <document> -- make a document private

Resolving a document

Prefer:

  1. document URL
  2. document id
  3. sharehtml list lookup by filename/title

If sharehtml list returns multiple plausible matches, show the candidates and ask the user which one they mean.

Safety rules

  • Treat sharehtml share as opt-in only.
  • If a user says "share this", that permits making the document shareable.
  • If a user only says "deploy this" or "upload this", do not make the document shareable.
  • Do not paste raw diff output unless the user asks for it.

© jonesphillip, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/sharehtml-collaboration of jonesphillip/sharehtml.

Open the folder on GitHubat commit 27ddaaf

Compare with similar skills

Sharehtml Collaboration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sharehtml Collaboration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sharehtml Collaboration this skilljonesphillip/sharehtml132—~902Automated safety check: PassApache-2.0
Cloudflarehodgef/apiker1277 repos~2.2kAutomated safety check: PassMIT
Durable Objectscloudflare/skills3k2 repos~1.5kAutomated safety check: PassApache-2.0
Durable Objectshodgef/apiker1274 repos~1.5kAutomated safety check: PassMIT
Cf Compatibility Checkelliothux/open-compute1.7k—~3.5kAutomated safety check: PassApache-2.0
Apikerhodgef/apiker127—~1.4kAutomated safety check: PassMIT

Similar skills

  • Cloudflare

    hodgef/apiker

    Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF…

    127 GitHub starsUsed in 7 repos~2.2k tokens
    DevOps & CloudAuto-check passed
  • Durable Objects

    cloudflare/skills

    Official

    Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.

    3k GitHub starsUsed in 2 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Durable Objects

    hodgef/apiker

    Create and review Cloudflare Durable Objects. An agent skill from hodgef/apiker.

    127 GitHub starsUsed in 4 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Cf Compatibility Check

    elliothux/open-compute

    Review branch and working-tree implementation changes for conformance with open-compute's Cloudflare Workers runtime target under explicit single-machine self-host exclusions.

    1.7k GitHub stars~3.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Apiker

    hodgef/apiker

    Develop, review, and extend the Apiker library — a framework for building serverless REST APIs on Cloudflare Workers + Durable Objects.

    127 GitHub stars~1.4k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Cloudflare Workers

    EpicenterHQ/epicenter

    Cloudflare Workers patterns for Worker runtime APIs, Durable Objects, KV, R2, D1, Queues, WebSockets, streaming responses, bindings, wrangler configuration, and deployment limits.

    4.8k GitHub stars~576 tokensUpdated today
    Backend & APIsAuto-check passed

Questions about Sharehtml Collaboration

What does Sharehtml Collaboration do?

A skill your agent uses when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI. Sharehtml Collaboration is an agent skill from jonesphillip/sharehtml. Use when a user wants to deploy, update, diff, pull, or review feedback on documents managed with the sharehtml CLI.

When should I use Sharehtml Collaboration?

Sharehtml Collaboration fits situations like: A user wants to deploy; review feedback on documents managed with the sharehtml CLI.

How do I install Sharehtml Collaboration in Claude Code?

Run `npx skills add jonesphillip/sharehtml --skill sharehtml-collaboration -a claude-code`. Or copy the skill folder (skills/sharehtml-collaboration in jonesphillip/sharehtml) into .claude/skills/sharehtml-collaboration in your project. Claude Code loads it when a task matches its description.

How do I install Sharehtml Collaboration in Codex?

Run `npx skills add jonesphillip/sharehtml --skill sharehtml-collaboration -a codex`. Or copy the skill folder (skills/sharehtml-collaboration in jonesphillip/sharehtml) into .agents/skills/sharehtml-collaboration in your project. Codex loads it when a task matches its description.

Can I use Sharehtml Collaboration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jonesphillip/sharehtml --skill sharehtml-collaboration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sharehtml-collaboration, .gemini/skills/sharehtml-collaboration, .github/skills/sharehtml-collaboration and .opencode/skills/sharehtml-collaboration in your project.

What does Sharehtml Collaboration need to run?

SKILL.md names no scripts, command-line tools or credentials: Sharehtml Collaboration is instructions for the agent only.

Does Sharehtml Collaboration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sharehtml Collaboration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sharehtml Collaboration use?

Sharehtml Collaboration is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sharehtml Collaboration use?

About 902 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sharehtml Collaboration?

Skills that share tags, products or a category with Sharehtml Collaboration: Cloudflare (hodgef/apiker, 127 stars), Durable Objects (cloudflare/skills, 3k stars), Durable Objects (hodgef/apiker, 127 stars) and Cf Compatibility Check (elliothux/open-compute, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sharehtml Collaboration?

jonesphillip (a GitHub user) maintains it in jonesphillip/sharehtml, which has 132 GitHub stars. The repository was last updated on April 9, 2026.

Source: jonesphillip/sharehtml on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.