htmlsharechecking
/ uses · learning · one page, the whole topic

the material, reorganised for revision.

notes are in the order they were taught, which is almost never the order that is useful for revision. the connections are across weeks and the summary exists nowhere.

writing the guide is genuinely the best revision available — and it is also the thing there is never time for in the week before an exam.

an assistant can do the reorganisation from your own material, which gets you to the version you can read, argue with, and correct. the arguing is where the learning is.

what you make
your notes, reorganised by theme
where it lives
in the page — shareable with your class
the important bit
the gaps it admits to rather than fills

a reorganisation, not a rewrite.

01 / what it is

the value here is structural. your notes contain the material; what they lack is an arrangement that makes the connections visible and the gaps obvious. an assistant can produce that arrangement from what you give it in a couple of minutes.

what it must not do is add content. a study guide that quietly imports facts from elsewhere is dangerous — you will learn things your course did not teach and, worse, things that are wrong. the prompt insists on this, and the gaps section is where that honesty becomes useful rather than merely safe.

  • your material grouped by theme rather than by week
  • definitions collected in one place
  • worked examples kept intact
  • a list of what your notes do not cover
  • a contents list you can revise against
  • print styles, because some revision happens on paper
what goes in
your notes, handouts, and anything else you paste
what comes out
the same material, regrouped, summarised and indexed
what it adds
nothing factual. gaps are listed, not filled
where it lives
in the page, so your study group can open the same url

see one in action.

02 / example
htmlshare.net/p/…
screen capture · silent loop
video coming soon

a term of notes reorganised into six themes, with definitions, worked examples and open questions

the live example is still being built — the prompt below is the one it was made with.

copy this, then make it yours.

03 / starting prompt

a starting point, not a template — the point of an agent is that the result is yours. change the sections to match what you want, and remove anything you don’t need.

starting prompt · paste into your ai
Build me a study guide as a single web page, from material I will paste in.

Ask me first:
- For the material — notes, handouts, a syllabus, past paper questions. Ask me to paste it, in as many messages as it takes.
- What the exam or assessment is, and its format if I know it.
- Whether there are topics I already know well and would rather see condensed.
- Whether I want worked examples kept in full or summarised.

BUILDING THE GUIDE

- Use only what I give you. Do not add facts, definitions, examples, formulas or context from your own knowledge, even where you are confident and even where my notes are clearly incomplete.
- Where my notes are thin or contradictory, list that in a "gaps and open questions" section rather than smoothing it over. That section is one of the most useful things on the page.
- Reorganise by theme rather than by the order I was taught. Say which sections of my material each theme came from.
- Collect every definition into one place, in my course's wording.
- Keep worked examples intact unless I said to summarise them.
- Where two parts of my notes connect, say so explicitly — the connections are what notes in chronological order hide.

WHAT THE PAGE DOES

- A contents list at the top, linking to each theme.
- Each theme: a short summary, then the detail, then anything unresolved.
- A search across the whole guide.
- Print styles that produce something readable on paper.
- No quiz, no flashcards, no interactivity beyond navigation — this is a document.

BE HONEST ON THE PAGE

- State that the guide was built from my own notes and contains no material from anywhere else.
- Keep the gaps section visible rather than buried at the bottom.

DELIVERY

- Produce one self-contained HTML file. Inline the CSS and JavaScript.
- No build step, no server, no framework, no package install, no external
  requests at runtime.
- Mobile-first and responsive; it has to be usable one-handed on a phone and
  still look right on a laptop.
- Accessible: semantic HTML, real contrast, visible keyboard focus, labelled
  controls, touch targets big enough to hit, and respect reduced-motion.
- Use placeholders where information is missing. Do not invent facts, numbers,
  names, dates, prices, or results I have not given you.
- Before you call it finished, use it yourself: enter real-looking data, reload
  the page, and confirm nothing is lost or mangled.

PUBLISHING

Publish the finished page to HTMLShare and give me the link.

Use exactly one of the two paths below, preferring the first. Make the call
directly. Do not route it through a code sandbox, container, or computer-use
session — that is where the request gets blocked, and it is never necessary.

1. An HTMLShare integration or connector, if you have one configured.
   The page is permanent and owned by my account. Report the url and the
   siteId. There is no claimUrl or manageToken on this path — do not go
   looking for one, and do not switch paths in order to produce one.

2. Otherwise, publish anonymously over REST. No account, key, or signup is
   needed:

    POST https://api.htmlshare.net/v1/publish
    content-type: application/json

    {"html": "<!doctype html> ... "}

   The reference is https://htmlshare.net/docs and, for the full schema,
   https://api.htmlshare.net/openapi.json

   Report these from the response, in your reply and never inside the page:
     url          the public page
     claimUrl     a private link that is mine alone. opening it is how I keep
                  the page past its 24-hour expiry, or set an email reminder
                  before it goes. it carries the manage token, so it must
                  never appear in the published HTML or anywhere a visitor
                  could see it.
     manageToken  the only thing that can edit or delete this page later. it is
                  returned once and never again, so tell me what it is.

Tell me which of the two you used. If the path you reach for first is
unavailable in your environment, say so and tell me what you are switching to
before you publish — a permanent page on my account and a 24-hour anonymous
page are different things, and which one I get is my decision, not a detail.

If I ask for a change afterwards, update the existing page instead of
publishing again, so the URL I have already shared keeps working — through the
same integration on path 1, or with the manage token as an X-Manage-Token
header on path 2.

RECIPE MARKER

Include this tag in the <head>, exactly as written:

    <meta name="htmlshare-recipe" content="study-guide">

It tells htmlshare which recipe the page came from, so the library can count
that this one was actually made. It carries nothing else.
works as-is inclaudechatgptcodexcursorgrok
adapting it
paste everything, in batches.notes, handouts, the syllabus, past papers. the more of your actual material goes in, the less the guide has to leave out — and leaving out is what it will correctly do with anything you did not supply.
read the gaps section first.it is a list of what your notes do not cover. that is the most actionable thing on the page and the reason to ask for it explicitly.
argue with it.where the reorganisation seems wrong, say so and ask for it differently. having the argument is revision; reading a guide passively is not.

give it a url.

04 / publishing it

how you publish depends on how you’re working.

with an integration
if your assistant already has htmlshare connected — mcp or another supported integration — just ask it to publish the finished page and hand back the url. the page belongs to your account and is permanent. when you want a change, ask for an update to that same page rather than a new one.
with no integration
the prompt tells the assistant to post the html to the rest api instead, which needs no account and no key. it comes back with a live url you can open immediately, a private claim link, and a manage token. the claim link is how the page stops being temporary — keep it.
by hand
nothing stops you doing it yourself: have the assistant give you the html file and drop it on the htmlshare home page. same url, same page, one more step.
what matters here
this is the one learning page you actually want to send round, since the content is in it. claim it, then republish as you add material through the term.

a guide is built over a term, not a night.

05 / keeping it around
anonymous
24h

fine for one late session. the page stops serving after 24 hours with a 7-day recovery window.

keep it around
a guide built in week four is revised from in week twelve.
stable updates
you add material all term and republish. the link your study group has keeps working.
custom url
a page several people will open repeatedly deserves an address they can remember.

questions.

06 / questions
will it add things my course did not cover?

it is told not to, explicitly and more than once. that matters more here than anywhere else in this library — a guide that imports outside material teaches you things you will not be examined on and possibly things that are wrong.

what does it do when my notes are incomplete?

lists it in the gaps section rather than filling it in. that section is the most useful output of the whole exercise, because it tells you exactly what to go and ask about.

can i share it with my study group?

yes — the guide is in the page, so anyone with the url reads the same thing. worth agreeing who republishes, so you do not end up with four versions.

is this cheating?

reorganising your own notes is revision, and arguing with the arrangement is where most of the learning happens. what you do with it is between you and your institution’s rules, which are worth reading.