{"id":"5b384c83-992b-4549-8fcc-c769201c51fa","shortId":"EhZeY9","kind":"skill","title":"flow-sync-status","tagline":"Use when syncing Beads state to markdown, checking Flow status, refreshing context docs, validating task markers, or reporting ready/blocked Flow work.","description":"# Flow Sync And Status\n\nUse this lifecycle skill for status dashboards, sync, context refresh, cleanup checks, and drift reporting.\n\n## Workflow\n\n1. Read `.agents/beads.json` before any sync/export decision.\n2. Pull Beads state and notes as the source of truth.\n3. Regenerate synchronized markdown views without changing requirement text.\n4. Detect drift in workflow commands, tech stack, patterns, knowledge chapters, and references.\n5. Report ready, blocked, in-progress, and stale work with clear next actions.\n\n## Guardrails\n\n- Sync reads backend state; do not close, block, or mutate tasks during status reporting.\n- Do not run export, auto-stage, or Dolt push unless policy or the user explicitly allows it.\n- Preserve human-written spec content; only update synchronized task/status regions.\n- Ask before applying context-doc updates when sync detects drift.\n\n## Validation\n\n- Confirm status comes from Beads, not markdown markers.\n- Confirm broken file references, workflow drift, and sync policy decisions are reported.\n- For this repo, run `make validate-skills` after skill or command sync changes.\n\n## References Index\n\n- [Sync](../flow/references/sync.md)\n- [Status](../flow/references/status.md)\n- [Refresh](../flow/references/refresh.md)\n- [Cleanup](../flow/references/cleanup.md)\n\n## Example\n\nUser: \"Flow status.\"\n\nAction: read Beads state, summarize active flows, ready tasks, blockers, recent notes, and whether markdown views need sync.","tags":["flow","sync","status","cofin","agent-skills","ai-agents","beads","claude-code","codex","cursor","developer-tools","gemini-cli"],"capabilities":["skill","source-cofin","skill-flow-sync-status","topic-agent-skills","topic-ai-agents","topic-beads","topic-claude-code","topic-codex","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-opencode","topic-plugin","topic-slash-commands","topic-spec-driven-development"],"categories":["flow"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/cofin/flow/flow-sync-status","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add cofin/flow","source_repo":"https://github.com/cofin/flow","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 11 github stars · SKILL.md body (1,455 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:07:37.023Z","embedding":null,"createdAt":"2026-04-27T01:03:22.132Z","updatedAt":"2026-05-18T19:07:37.023Z","lastSeenAt":"2026-05-18T19:07:37.023Z","tsv":"'/flow/references/cleanup.md':199 '/flow/references/refresh.md':197 '/flow/references/status.md':195 '/flow/references/sync.md':193 '1':46 '2':53 '3':64 '4':73 '5':86 'action':99,204 'activ':209 'agents/beads.json':48 'allow':131 'appli':146 'ask':144 'auto':120 'auto-stag':119 'backend':103 'bead':8,55,160,206 'block':89,108 'blocker':213 'broken':165 'chang':70,189 'chapter':83 'check':12,41 'cleanup':40,198 'clear':97 'close':107 'come':158 'command':78,187 'confirm':156,164 'content':138 'context':16,38,148 'context-doc':147 'dashboard':36 'decis':52,173 'detect':74,153 'doc':17,149 'dolt':123 'drift':43,75,154,169 'exampl':200 'explicit':130 'export':118 'file':166 'flow':2,13,24,26,202,210 'flow-sync-status':1 'guardrail':100 'human':135 'human-written':134 'in-progress':90 'index':191 'knowledg':82 'lifecycl':32 'make':180 'markdown':11,67,162,218 'marker':20,163 'mutat':110 'need':220 'next':98 'note':58,215 'pattern':81 'polici':126,172 'preserv':133 'progress':92 'pull':54 'push':124 'read':47,102,205 'readi':88,211 'ready/blocked':23 'recent':214 'refer':85,167,190 'refresh':15,39,196 'regener':65 'region':143 'repo':178 'report':22,44,87,114,175 'requir':71 'run':117,179 'skill':33,183,185 'skill-flow-sync-status' 'sourc':61 'source-cofin' 'spec':137 'stack':80 'stage':121 'stale':94 'state':9,56,104,207 'status':4,14,29,35,113,157,194,203 'summar':208 'sync':3,7,27,37,101,152,171,188,192,221 'sync/export':51 'synchron':66,141 'task':19,111,212 'task/status':142 'tech':79 'text':72 'topic-agent-skills' 'topic-ai-agents' 'topic-beads' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-opencode' 'topic-plugin' 'topic-slash-commands' 'topic-spec-driven-development' 'truth':63 'unless':125 'updat':140,150 'use':5,30 'user':129,201 'valid':18,155,182 'validate-skil':181 'view':68,219 'whether':217 'without':69 'work':25,95 'workflow':45,77,168 'written':136","prices":[{"id":"1c37e5bf-0627-4535-a193-23417f2c8081","listingId":"5b384c83-992b-4549-8fcc-c769201c51fa","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"cofin","category":"flow","install_from":"skills.sh"},"createdAt":"2026-04-27T01:03:22.132Z"}],"sources":[{"listingId":"5b384c83-992b-4549-8fcc-c769201c51fa","source":"github","sourceId":"cofin/flow/flow-sync-status","sourceUrl":"https://github.com/cofin/flow/tree/main/skills/flow-sync-status","isPrimary":false,"firstSeenAt":"2026-04-27T01:03:22.132Z","lastSeenAt":"2026-05-18T19:07:37.023Z"}],"details":{"listingId":"5b384c83-992b-4549-8fcc-c769201c51fa","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cofin","slug":"flow-sync-status","github":{"repo":"cofin/flow","stars":11,"topics":["agent-skills","ai-agents","beads","claude-code","codex","context-driven-development","cursor","developer-tools","gemini-cli","opencode","plugin","slash-commands","spec-driven-development","subagents","tdd","workflow"],"license":"apache-2.0","html_url":"https://github.com/cofin/flow","pushed_at":"2026-04-27T19:07:26Z","description":"Context-Driven Development toolkit for AI agents — spec-first planning, TDD workflow, and Beads integration.","skill_md_sha":"2e2dbff370c7c24506192b4c888c6e300357fdc8","skill_md_path":"skills/flow-sync-status/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cofin/flow/tree/main/skills/flow-sync-status"},"layout":"multi","source":"github","category":"flow","frontmatter":{"name":"flow-sync-status","description":"Use when syncing Beads state to markdown, checking Flow status, refreshing context docs, validating task markers, or reporting ready/blocked Flow work."},"skills_sh_url":"https://skills.sh/cofin/flow/flow-sync-status"},"updatedAt":"2026-05-18T19:07:37.023Z"}}