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"
}