cofin/flow-sync-status
skills/flow-sync-status/SKILL.md
Use when syncing Beads state to markdown, checking Flow status, refreshing context docs, validating task markers, or reporting ready/blocked Flow work.
$ install --global
skillsauthnpx skillsauth add cofin/flow flow-sync-statusInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 27, 2026, 5:34 AM276.5s2 files scanned
SKILL.md
- 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.
Flow Sync And Status
Use this lifecycle skill for status dashboards, sync, context refresh, cleanup checks, and drift reporting.
Workflow
- Read
.agents/beads.jsonbefore any sync/export decision. - Pull Beads state and notes as the source of truth.
- Regenerate synchronized markdown views without changing requirement text.
- Detect drift in workflow commands, tech stack, patterns, knowledge chapters, and references.
- Report ready, blocked, in-progress, and stale work with clear next actions.
Guardrails
- Sync reads backend state; do not close, block, or mutate tasks during status reporting.
- Do not run export, auto-stage, or Dolt push unless policy or the user explicitly allows it.
- Preserve human-written spec content; only update synchronized task/status regions.
- Ask before applying context-doc updates when sync detects drift.
Validation
- Confirm status comes from Beads, not markdown markers.
- Confirm broken file references, workflow drift, and sync policy decisions are reported.
- For this repo, run
make validate-skillsafter skill or command sync changes.
References Index
- Sync
- Status
- Refresh
- Cleanup
Example
User: "Flow status."
Action: read Beads state, summarize active flows, ready tasks, blockers, recent notes, and whether markdown views need sync.
Related Skills
cofin/flow-setup
testing
VerifiedTrustedCommunity
Use when initializing Flow in a repo, configuring .agents, installing or checking Beads bd, setting local-only sync policy, or creating first project context files.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-planning
data-ai
VerifiedTrustedCommunity
Use when drafting PRDs, researching, planning, refining, revising, or creating .agents/specs/<flow_id>/spec.md worksheets for Flow.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-execution
testing
VerifiedTrustedCommunity
Use when implementing Flow tasks from Beads or spec.md, claiming ready work, applying TDD, recording task notes, committing, and syncing after task state changes.
11SKILL.mdUpdated Apr 27, 2026
cofin/flow-completion
tools
VerifiedTrustedCommunity
Use when reviewing, finishing, archiving, reverting, validating, or cleaning up Flow work after implementation or phase completion.
11SKILL.mdUpdated Apr 27, 2026