buildbetter-backfill-smart-tag
Installation
SKILL.md
Backfill a Smart Tag
Requires the BuildBetter MCP release that exposes list-tag-groups,
list-tag-group-tags, and the durable Smart Tag workflow tools below. Do not
install or distribute this skill against an older production MCP inventory.
Workflow
- Resolve the tag with
list-tag-groupsandlist-tag-group-tags, then callget-smart-tag-workflowusing its canonicalmemberId. - Require a published workflow and confirm the same group remains visible and writable. Never substitute a same-name group or create a new group for replay.
- Collect an inclusive start, exclusive end, and maximum record count. The member's group owns the target. Keep
allowLargeReplayfalse unless the user explicitly approves a large cohort. - Call
preview-smart-tag-backfillwithmemberId, current revision, dates, limit, and large-replay setting. Report matched objects, existing exact associations, replay candidates, truncation, and maximum credits. - Explain billing: each newly inserted AI-produced tag association costs one credit. Existing associations, filtered-out objects, and no-match results cost zero. The preview is an upper bound; operation status is exact.
- Obtain explicit approval for the exact preview. Generate one idempotency UUID and call
start-smart-tag-backfillwith the same member, revision, scope, and the approved preview. Reuse the UUID only after an unknown result for that identical start. - Report the operation ID immediately. Poll
get-smart-tag-backfillwith the same member and operation IDs until terminal when completion is requested. Report pending/running/completed/failed/cancelled objects, inserted associations, and exact credits. - Use
cancel-smart-tag-backfillorresume-smart-tag-backfillon that same operation only when requested.