{"id":"8bce9b31-5eb3-4506-ba36-6e24f48a1be1","shortId":"pWZ4Ms","kind":"skill","title":"flow-setup","tagline":"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.","description":"# Flow Setup\n\nUse this lifecycle skill for project initialization, installation checks, setup validation, and first context files.\n\n## Workflow\n\n1. Detect project root, existing `.agents/` state, Beads availability, and repo-native commands.\n2. If Beads is missing, offer official Beads (`bd`) installation or no-Beads degraded mode.\n3. Initialize Flow context files from templates and prefer local-only Beads settings.\n4. Store setup decisions in Beads notes when a backend exists.\n5. Re-run setup validation before handing off to planning.\n\n## Guardrails\n\n- Prefer `.git/info/exclude` for local-only ignores.\n- Do not edit `.gitignore` unless the user wants shared repository policy.\n- Do not run `bd dolt push`, export, or auto-stage unless policy explicitly allows it.\n- Keep setup idempotent; preserve existing user context files and merge rather than overwrite.\n\n## Validation\n\n- Confirm `.agents/` root, `workflow.md`, `patterns.md`, `knowledge/index.md`, and Beads config existence when setup is expected.\n- Confirm Beads config defaults are local-only: no git ops, no auto export, and no auto git add.\n- Run repository validation commands documented in `.agents/workflow.md` or hook context.\n\n## References Index\n\n- [Setup command details](../flow/references/setup.md)\n- [Validate command details](../flow/references/validate.md)\n- [Refresh command details](../flow/references/refresh.md)\n\n## Example\n\nUser: \"Use Flow to set up this repo.\"\n\nAction: detect the repo root, initialize `.agents/`, configure local-only Beads, capture setup notes, validate files, then hand off to `flow-planning` for the first flow.","tags":["flow","setup","cofin","agent-skills","ai-agents","beads","claude-code","codex","cursor","developer-tools","gemini-cli","opencode"],"capabilities":["skill","source-cofin","skill-flow-setup","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-setup","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,620 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:36.906Z","embedding":null,"createdAt":"2026-04-27T01:03:22.030Z","updatedAt":"2026-05-18T19:07:36.906Z","lastSeenAt":"2026-05-18T19:07:36.906Z","tsv":"'/flow/references/refresh.md':219 '/flow/references/setup.md':211 '/flow/references/validate.md':215 '1':48 '2':62 '3':78 '4':92 '5':103 'action':229 'add':195 'agent':12,53,164,235 'agents/workflow.md':202 'allow':147 'auto':142,189,193 'auto-stag':141 'avail':56 'backend':101 'bd':17,70,136 'bead':16,55,64,69,75,90,97,170,178,240 'captur':241 'check':15,40 'command':61,199,209,213,217 'config':171,179 'configur':11,236 'confirm':163,177 'context':28,45,81,155,205 'creat':25 'decis':95 'default':180 'degrad':76 'detail':210,214,218 'detect':49,230 'document':200 'dolt':137 'edit':124 'exampl':220 'exist':52,102,153,172 'expect':176 'explicit':146 'export':139,190 'file':29,46,82,156,245 'first':26,44,255 'flow':2,7,30,80,223,251,256 'flow-plan':250 'flow-setup':1 'git':186,194 'git/info/exclude':116 'gitignor':125 'guardrail':114 'hand':110,247 'hook':204 'idempot':151 'ignor':121 'index':207 'initi':6,38,79,234 'instal':13,39,71 'keep':149 'knowledge/index.md':168 'lifecycl':34 'local':20,88,119,183,238 'local-on':19,87,118,182,237 'merg':158 'miss':66 'mode':77 'nativ':60 'no-bead':73 'note':98,243 'offer':67 'offici':68 'op':187 'overwrit':161 'patterns.md':167 'plan':113,252 'polici':23,132,145 'prefer':86,115 'preserv':152 'project':27,37,50 'push':138 'rather':159 're':105 're-run':104 'refer':206 'refresh':216 'repo':10,59,228,232 'repo-n':58 'repositori':131,197 'root':51,165,233 'run':106,135,196 'set':18,91,225 'setup':3,31,41,94,107,150,174,208,242 'share':130 'skill':35 'skill-flow-setup' 'source-cofin' 'stage':143 'state':54 'store':93 'sync':22 'templat':84 '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' 'unless':126,144 'use':4,32,222 'user':128,154,221 'valid':42,108,162,198,212,244 'want':129 'workflow':47 'workflow.md':166","prices":[{"id":"0a378473-45c4-4cf7-9940-a632add0aff6","listingId":"8bce9b31-5eb3-4506-ba36-6e24f48a1be1","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.030Z"}],"sources":[{"listingId":"8bce9b31-5eb3-4506-ba36-6e24f48a1be1","source":"github","sourceId":"cofin/flow/flow-setup","sourceUrl":"https://github.com/cofin/flow/tree/main/skills/flow-setup","isPrimary":false,"firstSeenAt":"2026-04-27T01:03:22.030Z","lastSeenAt":"2026-05-18T19:07:36.906Z"}],"details":{"listingId":"8bce9b31-5eb3-4506-ba36-6e24f48a1be1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"cofin","slug":"flow-setup","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":"c01036cdcf2b539eecc62b910527e23c138b6745","skill_md_path":"skills/flow-setup/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/cofin/flow/tree/main/skills/flow-setup"},"layout":"multi","source":"github","category":"flow","frontmatter":{"name":"flow-setup","description":"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."},"skills_sh_url":"https://skills.sh/cofin/flow/flow-setup"},"updatedAt":"2026-05-18T19:07:36.906Z"}}