Update artifacts skills

1 hour ago

This pull request adds two Agent Skills to bisque-cloud artifacts. Ask your agent for a plan, a report, or a sign-up sheet, and it publishes the answer as a page at a link that never changes. When the plan changes, the agent updates the same link, and when people comment, it answers them.

Ask about this presentation

Chapters

  1. 0:00A page at a link that never changes
  2. 0:19What you can ask for
  3. 0:35Two skills split the work
  4. 0:56Publishing
  5. 1:15Updating
  6. 1:37Who can open it
  7. 1:59The comment loop
  8. 2:19The rules that stay
  9. 2:42What to review
  10. 3:10Install
Show transcript
  1. This pull request adds two Agent Skills to bisque-cloud artifacts. Ask your agent for a plan, a report, or a sign-up sheet, and it publishes the answer as a page at a link that never changes. When the plan changes, the agent updates the same link, and when people comment, it answers them.

    Slide text
    bisque.today/… bisque-cloud/artifacts

    Your agent's answer becomes a page at a link that never changes.

    artifacts artifact-comments
  2. The README opens with what you can ask for. Write up the migration plan as an Artifact and share it with Ana as an editor. Your agent writes the document, publishes it, shares it, and hands you the link. Ana can open it, comment on it, and publish changes of her own.

    Slide text
    bisque.today/… README

    Ask for the plan, and get a link to send.

    YOU
    Write up the migration plan as an Artifact and share it with ana@acme.com as an editor.
    YOUR AGENT
    Writes the document, publishes it, shares it with Ana, and hands you the link. Ana can open it, comment, and publish changes of her own.
  3. The skills split the work in two. The artifacts skill publishes a Markdown document or an HTML page, updates it at the same link, shares it, and deletes it. The artifact-comments skill finds the threads that mention the agent, answers them, and resolves them. Both call the Bisque MCP server, so nothing is stored locally.

    Slide text
    bisque.today/… skills/

    One skill publishes pages and the other answers their comments.

    artifacts
    Publishes Markdown or HTML, updates it at the same link, shares it, deletes it.
    artifact-comments
    Finds threads that mention the agent, answers them, resolves them.
    Both call the Bisque MCP server at bisque.today/mcp
  4. To publish, the agent calls create_artifact. It sends a title, a type, and the complete content. Markdown suits a document read top to bottom, like a plan or meeting notes. HTML suits a dashboard, a form, or a poll, and it can keep shared data that everyone who opens the page sees live.

    Slide text
    bisque.today/… skills/artifacts/SKILL.md

    Publishing sends the whole document, never a diff.

    "name": "create_artifact", "arguments": { "title": "Q3 revenue by region", "type": "html", "content": "<!doctype html>…", "description": "Revenue by region for Q3, with the EMEA dip flagged." }
    markdown
    A document read top to bottom: a plan, a report, meeting notes.
    html
    A dashboard, a form, a poll. It can keep data everyone shares.
  5. Updating works the same way. The agent calls update_artifact with the artifact ID and the whole new content. That publishes a new version at the same URL, and the earlier versions stay in the history. The skill is explicit that the agent never creates a second Artifact to update the first, because the link you already sent would go stale.

    Slide text
    bisque.today/… update_artifact

    Updates land at the same link.

    update_artifact { artifact_id, content }
    v1 v2 v3 · live
    Never create a second Artifact to “update” the first: the link the user already sent would go stale.
  6. Who can open the page is the audience field. It starts at owner, so only you. Users opens it to the people you name, and org opens it to a bisque.team company. Public means anyone with the link. That deletes every comment thread, because comments don't exist on a public page, so the skill refuses unless the user has said in words that the comments can go.

    Slide text
    bisque.today/… share_artifact · audience

    Every Artifact starts private, and one field widens it.

    owner Only you. This is the default.
    users The people you name, as viewers or editors.
    org Every member of your bisque.team organization.
    public Anyone with the link, signed in or not.
    Going public deletes every comment thread, so the agent asks first.
  7. The second skill closes the loop. It lists the open threads where someone mentioned the agent. It makes the change and republishes. It replies in the thread with what changed and in which version. Then it resolves the thread. The order matters, because a thread resolved without a reply leaves the person guessing.

    Slide text
    bisque.today/… skills/artifact-comments/SKILL.md

    A mention in a comment thread becomes the agent's to-do.

    Find
    list_artifact_threads
    Change
    update_artifact
    Reply
    reply_to_artifact_thread
    Resolve
    resolve_artifact_thread
    A thread resolved without a reply leaves the person guessing.
  8. CONTRIBUTING calls the rules at the end of each SKILL.md load-bearing rather than stylistic. The agent confirms before anything that removes access or content. It never guesses an email address, since sharing with a guess shares with whoever owns it. And it updates the existing Artifact instead of publishing a copy. A change that removes one has to say what replaces it.

    Slide text
    bisque.today/… CONTRIBUTING.md

    The closing rules of each skill are load-bearing, not stylistic.

    Confirm before anything removes access or content.
    Never guess an email address.
    Update the existing Artifact instead of publishing a copy.
    A change that removes one needs to say what replaces it.
  9. The pull request body is two lines, so there is no benchmark or before and after to show, and the review thread has no comments. That is the whole description. What changed is six files: a plugin manifest at version 1.0.0, CONTRIBUTING, an MIT license, the README, and the two SKILL.md files. So the useful review is of the wording, because the SKILL.md files are the instructions your agent will follow.

    Slide text
    bisque.today/… pull request #1

    No benchmark or screenshot here, so review the wording.

    “Update artifacts skills

    See CONTRIBUTING.md for how to contribute.”
    .claude-plugin/plugin.json
    CONTRIBUTING.md
    LICENSE
    README.md
    skills/artifacts/SKILL.md
    skills/artifact-comments/SKILL.md
    The SKILL.md files are the instructions your agent follows.
  10. To try them, run this one command. It copies both skills into your agent's skills directory. The limit is that they need a Bisque account and network access to bisque.today, because everything runs through the MCP server. Then your agent's answer becomes a page at a link that never changes.

    Slide text
    bisque.today/… README · Install

    Try it: one command installs both.

    npx skills add bisque-cloud/artifacts
    It needs a Bisque account and network access to bisque.today.
    A page at a link that never changes.

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built in New York with ❤️