Update to AiAkiv Memory
Snapshot Oct 26, 2026 · 18:05 UTC · version 2.2.0
Collection source: downloaded plugin package. These snapshots do not have a confirmed matching collection source. Differences in file lists alone do not establish changes to the package.
Instructions updated for aiakiv-cards
Full description — Now says: memory with create_aiakiv_card. Use when the user asks to make a card, share a memory as a link or page, publish a summary card, or asks what AiAkiv cards...
Observed in instructions or declared skills. Runtime behavior has not been tested.
Up to 3 plugins free · no card required.
All fields and original values.
Full description
Sep 30, 2026 · 23:09 UTC
memory. Use when the user asks to make a card, share a memory as a link/page, publish a summary card, or asks what AiAkiv cards are or how to fix/delete one. A card is a one-page public site (card.aiakiv.com) written by YOU from memory s...
Oct 26, 2026 · 18:05 UTC
memory with create_aiakiv_card. Use when the user asks to make a card, share a memory as a link or page, publish a summary card, or asks what AiAkiv cards are or how to fix or delete one. A card is a one-page public site (card.aiakiv.com...
Skill instructions
Sep 30, 2026 · 23:09 UTC
--- name: aiakiv-cards description: >- Create a public AiAkiv card from the user's memory. Use when the user asks to make a card, share a memory as a link/page, publish a summary card, or asks what AiAkiv cards are or how to f...
Oct 26, 2026 · 18:05 UTC
--- name: aiakiv-cards description: >- Create a public AiAkiv card from the user's memory with create_aiakiv_card. Use when the user asks to make a card, share a memory as a link or page, publish a summary card, or asks what AiAkiv...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -1,101 +1,136 @@ ---- -name: aiakiv-cards -description: >- - Create a public AiAkiv card from the user's memory. Use when the user asks to - make a card, share a memory as a link/page, publish a summary card, or asks - what AiAkiv cards are or how to fix/delete one. A card is a one-page public - site (card.aiakiv.com) written by YOU from memory search results and baked by - the card service — live on the open web the moment it is created. ---- - -# AiAkiv cards - -A **card** is a one-page public summary of the user's AiAkiv memory: title, -3–5 bullets, a one-line conclusion, optional long body — plus two share images -with the short URL stamped in. Anyone with the address can view it, no login. -You create it through the shared app gateway; the server never calls a model — -**you write the content**. - -## The one fact that governs everything - -**Creating IS publishing.** The card is live on the open web the instant the -create call returns. Unlisted (nobody finds it without the address) but NOT -private. There is no draft state and no undo except deletion in the console. -So: filter before you create, and relay the response's `notice` to the user -first, verbatim. - -## Procedure - -1. **Search memory first** (`search_memory`). The card summarizes what is - actually stored — do not invent content. Set `source_count` to the number - of memories you actually used. -2. **Filter for sensitivity** — personal names, emails, internal addresses, - decisions not yet public. If the topic is at all sensitive, show the user a - draft and get a go-ahead before creating. -3. **Get the live format**: `run_aiakiv_app_action(app="card", action="describe")`. - Only `describe` and `create` exist — this tool cannot delete, edit, or - change search visibility. -4. **Write to fit the image, not just the limits.** `describe` returns - `bullets.renders` with the measured safe line width (~30 Hangul chars) and - max lines per bullet. Bullets share one fixed block of vertical space: - 5 bullets ≈ one safe line each; 3 bullets can run 2–3 lines each. Staying - under `max_chars_each` (120) is NOT enough. Aim to fit on the first try — - re-creating issues a NEW key and leaves the old card published and counted - against quota until the user deletes it in the console. -5. **Create**: `run_aiakiv_app_action(app="card", action="create", data={...})`. - Fields: `title` (≤80), `bullets` (3–5), `conclusion` (≤200), - `source_count`, `tags` (≤3, ≤20 chars each — these are the search terms on - card.aiakiv.com), `body` (optional, ≤30k chars, restricted markdown: - paragraphs, `##`, lists, `>`, code, bold/italic, http(s) links, `---`; - anything else renders as plain text). Title/bullets/conclusion/tags are - single-line — newlines collapse. If a long body gets mangled in transport, - pass `data` as one JSON **string**. - -## Handling the response - -- **`notice` comes first.** Relay it to the user before the link, before any - summary, uncompressed. It states the card is already public and how to take - it down. -- **`url`** — show verbatim as a clickable link. `og_url` / `square_url` are - the share images (Instagram / boards that don't unfurl links). -- **`fit`** (present only when something was cut) — report it as-is: - `bullets_truncated` / `bullets_dropped` are original bullet numbers, `hint` - says how much to shorten. The PAGE always shows full text; only the images - crop. Let the user decide whether to shorten and re-create — and if they do, - remind them the old card stays up until deleted. -- **Errors** (`{error, hint, field}`): `invalid_card` → fix the named field - and retry; `payload_too_large` → shrink the body; `quota_exceeded` (50 held / - 10 per hour / 30 per day) → tell the user; anything else → relay and stop. - On any error the card was NOT created — never say it was. - -## What you must not do - -- Create a card the user didn't ask for ("summarize this" is not a card request). -- Fill a card with content that isn't in memory. -- Claim you deleted a card or toggled search visibility — you can't. Manage- - ment (list, copy link, images, delete, search-visibility toggle) lives in - the AiAkiv console → Data → Cards (app.aiakiv.com). -- Offer to set the user's public nickname or attach filing tags — you can't. - Those are console-only too (see below). `data.tags` is a different thing: - card tags are baked into the image at create time and cannot be changed. -- Quietly re-create after a `fit` warning — that leaves two public cards. -- Paste the card's URL anywhere on the user's behalf; sharing is their call. - -## Useful context for the user - -- KakaoTalk / Slack / Discord / Notion / blogs unfurl the bare URL into a card. - Instagram and some board sites don't — upload the square/wide image instead; - the URL is stamped inside it. -- Search visibility is OFF by default. Turning it on (console) lists the card - on card.aiakiv.com search by title/tags; turning it off later un-lists it - but the card stays public to anyone with the address. -- card.aiakiv.com search narrows three ways — text, author nickname, filing - tag — and the address bar tracks whatever is narrowed, so any view can be - shared as a link. **Nickname and filing tags are set in the console, by the - user, not by you.** A nickname is optional; without one nothing identifying - the user is published. Their email is never published in any case. Filing - tags show on the card page and group cards in search; they never change the - card image. -- Deleting removes the page immediately, but third-party preview caches can - linger. Deleting the account does NOT delete cards — clean up in the console - first. +--- +name: aiakiv-cards +description: >- + Create a public AiAkiv card from the user's memory with create_aiakiv_card. + Use when the user asks to make a card, share a memory as a link or page, + publish a summary card, or asks what AiAkiv cards are or how to fix or delete + one. A card is a one-page public site (card.aiakiv.com) written by YOU from + memory search results and baked by the card service. It is live on the open + web the moment it is created. +--- + +# AiAkiv cards + +<!-- shared-create-section: begin. This block is identical in every edition of the aiakiv-cards skill. --> +A **card** is a one-page public summary of the user's AiAkiv memory: a title, +3 to 5 bullets, a one-line conclusion and an optional longer body, plus two +share images (a square one and a wide 1200x630 one) with the short address +stamped in. Anyone with the address can view it, no login. You create it with +`create_aiakiv_card`. The server never calls a model: **you write the +content**. + +## The one fact that governs everything + +**Creating IS publishing.** The card page and both images are live on the open +web the instant `create_aiakiv_card` returns. The card is unlisted (nobody +finds it without the address) but NOT private. There is no draft state, no +editing and no undo except deleting the card (see "Managing cards" below). So +filter before you create, and relay the response's `notice` to the user first, +verbatim. + +## Procedure + +1. **Search memory first** (`search_memory`, then `get_memory_content` when a + summary is not enough). The card summarizes what is actually stored; do not + invent content. Set `source_count` to the number of memories you actually + used. +2. **Filter for sensitivity**: personal names, emails, internal addresses, + decisions not yet public. +3. **Get consent to publish.** A request to make a card is consent to publish + that card. If the content touches anything sensitive, or you had to choose + what to leave out, show the user the draft and wait for an explicit yes + before creating. +4. **Write to fit the images, not just the limits** (see "Fitting the images"). + Aim to fit on the first try: creating again makes a NEW card at a new + address and leaves the first one published, and counted against the user's + card quota, until the user deletes it. +5. **Create** with `create_aiakiv_card`, passing the fields below directly. + There is no format lookup step before it. + +## Fields and limits + +The card service checks these after it trims whitespace and drops empty items. + +- `title`: one line, up to 80 characters. Required. +- `bullets`: 3 to 5 key points, one line each, up to 120 characters each. Required. +- `conclusion`: one line, up to 200 characters. Required. +- `source_count`: how many memories the card was written from, an integer of 0 or more. Defaults to 0. +- `tags`: up to 3 search terms for card.aiakiv.com, up to 20 characters each. They are drawn into the images and **cannot be changed later**. Defaults to none. +- `body`: optional longer text shown on the page but not in the images, up to 30,000 characters of restricted markdown: paragraphs, `##` headings, `-` and `1.` lists, `>` quotes, inline and fenced code, bold, italic, http(s) links and `---`. Anything else shows as plain text. + +Title, bullets, conclusion and tags are single lines: line breaks in them +collapse to spaces. + +## Fitting the images + +Bullets share one fixed block of vertical space, so their count and length +trade against each other. A line holds about 31 Korean characters (Latin +letters and spaces fit more) and each bullet gets up to 3 lines, but when the +total does not fit, every bullet is cut to fewer lines and shortened with an +ellipsis. Staying under 120 characters is not enough. + +What fits both images: a title of up to about 20 Korean characters, a +conclusion of up to about 30 Korean characters, and 3 or 4 bullets of up to +about 40 Korean characters each. With 5 bullets the last one is left out of +the wide image. The page always shows the full text; only the images crop. + +## Handling the response + +- **`notice` comes first.** Show it to the user before the link and before any + summary, uncompressed. It states what just became public and how to take it + down. +- **`url`** is the card page: show it verbatim as a clickable link. `og_url` + (wide) and `square_url` (square) are the share images. +- **`fit`** is present only when an image cut something. Report it as is: + `bullets_truncated` and `bullets_dropped` are original bullet numbers, + `title_truncated` or `conclusion_truncated` may also appear, and `hint` says + how much to shorten. Let the user decide whether to shorten and create again, + and if they do, remind them the first card stays up until they delete it. +- **Errors** come as `{error, message or hint, field}`. On any error no card was + made; never say it was. + - `invalid_card`: fix the named `field` and try again. + - `payload_too_large` or `request_too_large`: shorten the body. + - `quota_exceeded`: the response carries `window`, `limit` and `used`. Tell + the user which limit was reached; do not retry. + - Anything else: relay it and stop. + +## What you must not do + +- Create a card the user did not ask for ("summarize this" is not a card request). +- Fill a card with content that is not in memory. +- Quietly create again after a `fit` warning; that leaves two public cards. +- Say a card was made when the response was an error. +- Paste the card's address anywhere on the user's behalf; sharing is their call. + +## Sharing, for the user + +- KakaoTalk, Slack, Discord, Notion and blogs unfurl the bare address into a + card. Instagram and some board sites do not: upload the square or wide image + instead; the address is stamped inside it. +- Deleting removes the page immediately, but other sites' preview caches can + linger. Deleting the account does NOT delete cards, so delete them first. +<!-- shared-create-section: end --> + +## Managing cards + +`create_aiakiv_card` only creates. Editing a card's text is not possible +anywhere; create a new card instead (the old one stays up until deleted). + +Listing, deleting, search visibility and filing tags for cards the user +already made are done by the user in the AiAkiv web console (app.aiakiv.com, +Data, Cards). Point the user there when they ask for any of these, and never +say a card was deleted, hidden or changed unless the user tells you they did +it. + +- Search visibility is OFF by default. Turning it on in the web console lists + the card in card.aiakiv.com search by title and tags; turning it off later + un-lists it, but the card stays public to anyone with the address. +- Filing tags, set in the web console, are not the `tags` field. Filing tags + show on the card page and group cards in search; they never change the + image. +- The public nickname and the tag palette are set by the user in the web + console, not by you. A nickname is optional; without one nothing + identifying the user is published. Their email is never published. +- card.aiakiv.com search narrows three ways (text, author nickname, filing + tag), and the address bar tracks whatever is narrowed, so any view can be + shared as a link.
Full technical diff · 2 changed fields
changed /description
"Create a public AiAkiv card from the user's memory. Use when the user asks to make a card, share a memory as a link/page, publish a summary card, or asks what AiAkiv cards are or how to fix/delete one. A card is a one-page public site (card.aiakiv.com) written by YOU from memory search results and baked by the card service — live on the open web the moment it is created."
"Create a public AiAkiv card from the user's memory with create_aiakiv_card. Use when the user asks to make a card, share a memory as a link or page, publish a summary card, or asks what AiAkiv cards are or how to fix or delete one. A card is a one-page public site (card.aiakiv.com) written by YOU from memory search results and baked by the card service. It is live on the open web the moment it is created."
changed /skill_md_contents
"---\r\nname: aiakiv-cards\r\ndescription: >-\r\n Create a public AiAkiv card from the user's memory. Use when the user asks to\r\n make a card, share a memory as a link/page, publish a summary card, or asks\r\n what AiAkiv cards are or how to fix/delete one. A card is a one-page public\r\n site (card.aiakiv.com) written by YOU from memory search results and baked by\r\n the card service — live on the open web the moment it is created.\r\n---\r\n\r\n# AiAkiv cards\r\n\r\nA **card** is a one-page public summary of the user's AiAkiv memory: title,\r\n3–5 bullets, a one-line conclusion, optional long body — plus two share images\r\nwith the short URL stamped in. Anyone with the address can view it, no login.\r\nYou create it through the shared app gateway; the server never calls a model —\r\n**you write the content**.\r\n\r\n## The one fact that governs everything\r\n\r\n**Creating IS publishing.** The card is live on the open web the instant the\r\ncreate call returns. Unlisted (nobody finds it without the address) but NOT\r\nprivate. There is no draft state and no undo except deletion in the console.\r\nSo: filter before you create, and relay the response's `notice` to the user\r\nfirst, verbatim.\r\n\r\n## Procedure\r\n\r\n1. **Search memory first** (`search_memory`). The card summarizes what is\r\n actually stored — do not invent content. Set `source_count` to the number\r\n of memories you actually used.\r\n2. **Filter for sensitivity** — personal names, emails, internal addresses,\r\n decisions not yet public. If the topic is at all sensitive, show the user a\r\n draft and get a go-ahead before creating.\r\n3. **Get the live format**: `run_aiakiv_app_action(app=\"card\", action=\"describe\")`.\r\n Only `describe` and `create` exist — this tool cannot delete, edit, or\r\n change search visibility.\r\n4. **Write to fit the image, not just the limits.** `describe` returns\r\n `bullets.renders` with the measured safe line width (~30 Hangul chars) and\r\n max lines per bullet. Bullets share one fixed block of vertical space:\r\n 5 bullets ≈ one safe line each; 3 bullets can run 2–3 lines each. Staying\r\n under `max_chars_each` (120) is NOT enough. Aim to fit on the first try —\r\n re-creating issues a NEW key and leaves the old card published and counted\r\n against quota until the user deletes it in the console.\r\n5. **Create**: `run_aiakiv_app_action(app=\"card\", action=\"create\", data={...})`.\r\n Fields: `title` (≤80), `bullets` (3–5), `conclusion` (≤200),\r\n `source_count`, `tags` (≤3, ≤20 chars each — these are the search terms on\r\n card.aiakiv.com), `body` (optional, ≤30k chars, restricted markdown:\r\n paragraphs, `##`, lists, `>`, code, bold/italic, http(s) links, `---`;\r\n anything else renders as plain text). Title/bullets/conclusion/tags are\r\n single-line — newlines collapse. If a long body gets mangled in transport,\r\n pass `data` as one JSON **string**.\r\n\r\n## Handling the response\r\n\r\n- **`notice` comes first.** Relay it to the user before the link, before any\r\n summary, uncompressed. It states the card is already public and how to take\r\n it down.\r\n- **`url`** — show verbatim as a clickable link. `og_url` / `square_url` are\r\n the share images (Instagram / boards that don't unfurl links).\r\n- **`fit`** (present only when something was cut) — report it as-is:\r\n `bullets_truncated` / `bullets_dropped` are original bullet numbers, `hint`\r\n says how much to shorten. The PAGE always shows full text; only the images\r\n crop. Let the user decide whether to shorten and re-create — and if they do,\r\n remind them the old card stays up until deleted.\r\n- **Errors** (`{error, hint, field}`): `invalid_card` → fix the named field\r\n and retry; `payload_too_large` → shrink the body; `quota_exceeded` (50 held /\r\n 10 per hour / 30 per day) → tell the user; anything else → relay and stop.\r\n On any error the card was NOT created — never say it was.\r\n\r\n## What you must not do\r\n\r\n- Create a card the user didn't ask for (\"summarize this\" is not a card request).\r\n- Fill a card with content that isn't in memory.\r\n- Claim you deleted a card or toggled search visibility — you can't. Manage-\r\n ment (list, copy link, images, delete, search-visibility toggle) lives in\r\n the AiAkiv console → Data → Cards (app.aiakiv.com).\r\n- Offer to set the user's public nickname or attach filing tags — you can't.\r\n Those are console-only too (see below). `data.tags` is a different thing:\r\n card tags are baked into the image at create time and cannot be changed.\r\n- Quietly re-create after a `fit` warning — that leaves two public cards.\r\n- Paste the card's URL anywhere on the user's behalf; sharing is their call.\r\n\r\n## Useful context for the user\r\n\r\n- KakaoTalk / Slack / Discord / Notion / blogs unfurl the bare URL into a card.\r\n Instagram and some board sites don't — upload the square/wide image instead;\r\n the URL is stamped inside it.\r\n- Search visibility is OFF by default. Turning it on (console) lists the card\r\n on card.aiakiv.com search by title/tags; turning it off later un-lists it\r\n but the card stays public to anyone with the address.\r\n- card.aiakiv.com search narrows three ways — text, author nickname, filing\r\n tag — and the address bar tracks whatever is narrowed, so any view can be\r\n shared as a link. **Nickname and filing tags are set in the console, by the\r\n user, not by you.** A nickname is optional; without one nothing identifying\r\n the user is published. Their email is never published in any case. Filing\r\n tags show on the card page and group cards in search; they never change the\r\n card image.\r\n- Deleting removes the page immediately, but third-party preview caches can\r\n linger. Deleting the account does NOT delete cards — clean up in the console\r\n first.\r\n""---\nname: aiakiv-cards\ndescription: >-\n Create a public AiAkiv card from the user's memory with create_aiakiv_card.\n Use when the user asks to make a card, share a memory as a link or page,\n publish a summary card, or asks what AiAkiv cards are or how to fix or delete\n one. A card is a one-page public site (card.aiakiv.com) written by YOU from\n memory search results and baked by the card service. It is live on the open\n web the moment it is created.\n---\n\n# AiAkiv cards\n\n<!-- shared-create-section: begin. This block is identical in every edition of the aiakiv-cards skill. -->\nA **card** is a one-page public summary of the user's AiAkiv memory: a title,\n3 to 5 bullets, a one-line conclusion and an optional longer body, plus two\nshare images (a square one and a wide 1200x630 one) with the short address\nstamped in. Anyone with the address can view it, no login. You create it with\n`create_aiakiv_card`. The server never calls a model: **you write the\ncontent**.\n\n## The one fact that governs everything\n\n**Creating IS publishing.** The card page and both images are live on the open\nweb the instant `create_aiakiv_card` returns. The card is unlisted (nobody\nfinds it without the address) but NOT private. There is no draft state, no\nediting and no undo except deleting the card (see \"Managing cards\" below). So\nfilter before you create, and relay the response's `notice` to the user first,\nverbatim.\n\n## Procedure\n\n1. **Search memory first** (`search_memory`, then `get_memory_content` when a\n summary is not enough). The card summarizes what is actually stored; do not\n invent content. Set `source_count` to the number of memories you actually\n used.\n2. **Filter for sensitivity**: personal names, emails, internal addresses,\n decisions not yet public.\n3. **Get consent to publish.** A request to make a card is consent to publish\n that card. If the content touches anything sensitive, or you had to choose\n what to leave out, show the user the draft and wait for an explicit yes\n before creating.\n4. **Write to fit the images, not just the limits** (see \"Fitting the images\").\n Aim to fit on the first try: creating again makes a NEW card at a new\n address and leaves the first one published, and counted against the user's\n card quota, until the user deletes it.\n5. **Create** with `create_aiakiv_card`, passing the fields below directly.\n There is no format lookup step before it.\n\n## Fields and limits\n\nThe card service checks these after it trims whitespace and drops empty items.\n\n- `title`: one line, up to 80 characters. Required.\n- `bullets`: 3 to 5 key points, one line each, up to 120 characters each. Required.\n- `conclusion`: one line, up to 200 characters. Required.\n- `source_count`: how many memories the card was written from, an integer of 0 or more. Defaults to 0.\n- `tags`: up to 3 search terms for card.aiakiv.com, up to 20 characters each. They are drawn into the images and **cannot be changed later**. Defaults to none.\n- `body`: optional longer text shown on the page but not in the images, up to 30,000 characters of restricted markdown: paragraphs, `##` headings, `-` and `1.` lists, `>` quotes, inline and fenced code, bold, italic, http(s) links and `---`. Anything else shows as plain text.\n\nTitle, bullets, conclusion and tags are single lines: line breaks in them\ncollapse to spaces.\n\n## Fitting the images\n\nBullets share one fixed block of vertical space, so their count and length\ntrade against each other. A line holds about 31 Korean characters (Latin\nletters and spaces fit more) and each bullet gets up to 3 lines, but when the\ntotal does not fit, every bullet is cut to fewer lines and shortened with an\nellipsis. Staying under 120 characters is not enough.\n\nWhat fits both images: a title of up to about 20 Korean characters, a\nconclusion of up to about 30 Korean characters, and 3 or 4 bullets of up to\nabout 40 Korean characters each. With 5 bullets the last one is left out of\nthe wide image. The page always shows the full text; only the images crop.\n\n## Handling the response\n\n- **`notice` comes first.** Show it to the user before the link and before any\n summary, uncompressed. It states what just became public and how to take it\n down.\n- **`url`** is the card page: show it verbatim as a clickable link. `og_url`\n (wide) and `square_url` (square) are the share images.\n- **`fit`** is present only when an image cut something. Report it as is:\n `bullets_truncated` and `bullets_dropped` are original bullet numbers,\n `title_truncated` or `conclusion_truncated` may also appear, and `hint` says\n how much to shorten. Let the user decide whether to shorten and create again,\n and if they do, remind them the first card stays up until they delete it.\n- **Errors** come as `{error, message or hint, field}`. On any error no card was\n made; never say it was.\n - `invalid_card`: fix the named `field` and try again.\n - `payload_too_large` or `request_too_large`: shorten the body.\n - `quota_exceeded`: the response carries `window`, `limit` and `used`. Tell\n the user which limit was reached; do not retry.\n - Anything else: relay it and stop.\n\n## What you must not do\n\n- Create a card the user did not ask for (\"summarize this\" is not a card request).\n- Fill a card with content that is not in memory.\n- Quietly create again after a `fit` warning; that leaves two public cards.\n- Say a card was made when the response was an error.\n- Paste the card's address anywhere on the user's behalf; sharing is their call.\n\n## Sharing, for the user\n\n- KakaoTalk, Slack, Discord, Notion and blogs unfurl the bare address into a\n card. Instagram and some board sites do not: upload the square or wide image\n instead; the address is stamped inside it.\n- Deleting removes the page immediately, but other sites' preview caches can\n linger. Deleting the account does NOT delete cards, so delete them first.\n<!-- shared-create-section: end -->\n\n## Managing cards\n\n`create_aiakiv_card` only creates. Editing a card's text is not possible\nanywhere; create a new card instead (the old one stays up until deleted).\n\nListing, deleting, search visibility and filing tags for cards the user\nalready made are done by the user in the AiAkiv web console (app.aiakiv.com,\nData, Cards). Point the user there when they ask for any of these, and never\nsay a card was deleted, hidden or changed unless the user tells you they did\nit.\n\n- Search visibility is OFF by default. Turning it on in the web console lists\n the card in card.aiakiv.com search by title and tags; turning it off later\n un-lists it, but the card stays public to anyone with the address.\n- Filing tags, set in the web console, are not the `tags` field. Filing tags\n show on the card page and group cards in search; they never change the\n image.\n- The public nickname and the tag palette are set by the user in the web\n console, not by you. A nickname is optional; without one nothing\n identifying the user is published. Their email is never published.\n- card.aiakiv.com search narrows three ways (text, author nickname, filing\n tag), and the address bar tracks whatever is narrowed, so any view can be\n shared as a link.\n"Full snapshot data
{
"description": "Create a public AiAkiv card from the user's memory with create_aiakiv_card. Use when the user asks to make a card, share a memory as a link or page, publish a summary card, or asks what AiAkiv cards are or how to fix or delete one. A card is a one-page public site (card.aiakiv.com) written by YOU from memory search results and baked by the card service. It is live on the open web the moment it is created.",
"included_files": [],
"name": "aiakiv-cards",
"skill_md_contents": "---\nname: aiakiv-cards\ndescription: >-\n Create a public AiAkiv card from the user's memory with create_aiakiv_card.\n Use when the user asks to make a card, share a memory as a link or page,\n publish a summary card, or asks what AiAkiv cards are or how to fix or delete\n one. A card is a one-page public site (card.aiakiv.com) written by YOU from\n memory search results and baked by the card service. It is live on the open\n web the moment it is created.\n---\n\n# AiAkiv cards\n\n<!-- shared-create-section: begin. This block is identical in every edition of the aiakiv-cards skill. -->\nA **card** is a one-page public summary of the user's AiAkiv memory: a title,\n3 to 5 bullets, a one-line conclusion and an optional longer body, plus two\nshare images (a square one and a wide 1200x630 one) with the short address\nstamped in. Anyone with the address can view it, no login. You create it with\n`create_aiakiv_card`. The server never calls a model: **you write the\ncontent**.\n\n## The one fact that governs everything\n\n**Creating IS publishing.** The card page and both images are live on the open\nweb the instant `create_aiakiv_card` returns. The card is unlisted (nobody\nfinds it without the address) but NOT private. There is no draft state, no\nediting and no undo except deleting the card (see \"Managing cards\" below). So\nfilter before you create, and relay the response's `notice` to the user first,\nverbatim.\n\n## Procedure\n\n1. **Search memory first** (`search_memory`, then `get_memory_content` when a\n summary is not enough). The card summarizes what is actually stored; do not\n invent content. Set `source_count` to the number of memories you actually\n used.\n2. **Filter for sensitivity**: personal names, emails, internal addresses,\n decisions not yet public.\n3. **Get consent to publish.** A request to make a card is consent to publish\n that card. If the content touches anything sensitive, or you had to choose\n what to leave out, show the user the draft and wait for an explicit yes\n before creating.\n4. **Write to fit the images, not just the limits** (see \"Fitting the images\").\n Aim to fit on the first try: creating again makes a NEW card at a new\n address and leaves the first one published, and counted against the user's\n card quota, until the user deletes it.\n5. **Create** with `create_aiakiv_card`, passing the fields below directly.\n There is no format lookup step before it.\n\n## Fields and limits\n\nThe card service checks these after it trims whitespace and drops empty items.\n\n- `title`: one line, up to 80 characters. Required.\n- `bullets`: 3 to 5 key points, one line each, up to 120 characters each. Required.\n- `conclusion`: one line, up to 200 characters. Required.\n- `source_count`: how many memories the card was written from, an integer of 0 or more. Defaults to 0.\n- `tags`: up to 3 search terms for card.aiakiv.com, up to 20 characters each. They are drawn into the images and **cannot be changed later**. Defaults to none.\n- `body`: optional longer text shown on the page but not in the images, up to 30,000 characters of restricted markdown: paragraphs, `##` headings, `-` and `1.` lists, `>` quotes, inline and fenced code, bold, italic, http(s) links and `---`. Anything else shows as plain text.\n\nTitle, bullets, conclusion and tags are single lines: line breaks in them\ncollapse to spaces.\n\n## Fitting the images\n\nBullets share one fixed block of vertical space, so their count and length\ntrade against each other. A line holds about 31 Korean characters (Latin\nletters and spaces fit more) and each bullet gets up to 3 lines, but when the\ntotal does not fit, every bullet is cut to fewer lines and shortened with an\nellipsis. Staying under 120 characters is not enough.\n\nWhat fits both images: a title of up to about 20 Korean characters, a\nconclusion of up to about 30 Korean characters, and 3 or 4 bullets of up to\nabout 40 Korean characters each. With 5 bullets the last one is left out of\nthe wide image. The page always shows the full text; only the images crop.\n\n## Handling the response\n\n- **`notice` comes first.** Show it to the user before the link and before any\n summary, uncompressed. It states what just became public and how to take it\n down.\n- **`url`** is the card page: show it verbatim as a clickable link. `og_url`\n (wide) and `square_url` (square) are the share images.\n- **`fit`** is present only when an image cut something. Report it as is:\n `bullets_truncated` and `bullets_dropped` are original bullet numbers,\n `title_truncated` or `conclusion_truncated` may also appear, and `hint` says\n how much to shorten. Let the user decide whether to shorten and create again,\n and if they do, remind them the first card stays up until they delete it.\n- **Errors** come as `{error, message or hint, field}`. On any error no card was\n made; never say it was.\n - `invalid_card`: fix the named `field` and try again.\n - `payload_too_large` or `request_too_large`: shorten the body.\n - `quota_exceeded`: the response carries `window`, `limit` and `used`. Tell\n the user which limit was reached; do not retry.\n - Anything else: relay it and stop.\n\n## What you must not do\n\n- Create a card the user did not ask for (\"summarize this\" is not a card request).\n- Fill a card with content that is not in memory.\n- Quietly create again after a `fit` warning; that leaves two public cards.\n- Say a card was made when the response was an error.\n- Paste the card's address anywhere on the user's behalf; sharing is their call.\n\n## Sharing, for the user\n\n- KakaoTalk, Slack, Discord, Notion and blogs unfurl the bare address into a\n card. Instagram and some board sites do not: upload the square or wide image\n instead; the address is stamped inside it.\n- Deleting removes the page immediately, but other sites' preview caches can\n linger. Deleting the account does NOT delete cards, so delete them first.\n<!-- shared-create-section: end -->\n\n## Managing cards\n\n`create_aiakiv_card` only creates. Editing a card's text is not possible\nanywhere; create a new card instead (the old one stays up until deleted).\n\nListing, deleting, search visibility and filing tags for cards the user\nalready made are done by the user in the AiAkiv web console (app.aiakiv.com,\nData, Cards). Point the user there when they ask for any of these, and never\nsay a card was deleted, hidden or changed unless the user tells you they did\nit.\n\n- Search visibility is OFF by default. Turning it on in the web console lists\n the card in card.aiakiv.com search by title and tags; turning it off later\n un-lists it, but the card stays public to anyone with the address.\n- Filing tags, set in the web console, are not the `tags` field. Filing tags\n show on the card page and group cards in search; they never change the\n image.\n- The public nickname and the tag palette are set by the user in the web\n console, not by you. A nickname is optional; without one nothing\n identifying the user is published. Their email is never published.\n- card.aiakiv.com search narrows three ways (text, author nickname, filing\n tag), and the address bar tracks whatever is narrowed, so any view can be\n shared as a link.\n"
}SHA-256 of public snapshot: b0f3afc6310d6a1d1faf918442207fff8c7dde1ece158ccc24f62a44b1749b2d