AI Update
Update a synced listing with an agent
Use this prompt when a founder already has `useful.json` installed and wants to refresh listing copy or add new release-note style updates while respecting moderation boundaries.
The canonical schema lives at /api/useful-json-schema. The canonical instructions live at /ai/useful-json-instructions.
Update prompt
Copy this directly into an AI agent conversation.
You are helping a founder update an existing useful.json file for theuseful.website. Your job: 1. Ask what changed since the last update. 2. Update the useful.json fields that should change. 3. Keep update entries concise and factual. Ask these questions first: - What changed in the product since the last useful.json version? - Are there new launches, release notes, integrations, or major improvements to add? - Did the tagline or description change materially? - Did pricing model, package pricing, version, what's new, discount code, logo, or social handle change? - Did category change? If yes, note it clearly because category updates require admin verification. - Are there any details that should not be synced automatically yet? Then return: 1. the updated useful.json 2. a short summary of what changed Sync rules: - These can auto-sync: name, tagline, description, pricing, price, version, whatsNew, discountCode, tags, logo, twitter, and updates. - These need admin verification: category changes and any protected editorial decisions. - version, whatsNew, and updates are only for user-facing product changes. - Do not use them for internal refactors, maintenance work, dependency bumps, or invisible fixes. - Keep updates focused on product news, not general marketing claims. - Return strict JSON only. Do not add comments after the JSON document. - Always keep these stable agent URLs in the file: - "agentInstallUrl": "https://theuseful.website/ai/installation" - "agentUpdateUrl": "https://theuseful.website/ai/update-listing" - Do not invent dates or release notes. After updating the file, remind the user: "Your listing will sync automatically once theuseful.website picks up the new useful.json. If you want to update again in the future, run /update-useful-json (if you have the skill installed) or tell me to update your useful.json and I will fetch fresh instructions from https://theuseful.website/ai/update-listing."
Verification rules
Copy this directly into an AI agent conversation.
Auto-sync now:
- name
- tagline
- description
- pricing
- price
- version
- whatsNew
- discountCode
- tags
- logo
- twitter
- updates
Admin review required:
- category change
- anything that should alter moderation/editorial positioning
Suggested update entry shape:
{
"id": "stable-update-id",
"title": "Short release title",
"summary": "One sentence summary of the release or launch.",
"url": "https://example.com/changelog/entry",
"publishedAt": "2026-04-01T00:00:00.000Z"
}