Skip to content
Skills Library
Programming · Building & coding

flow-setup

/flow-setup

Use when initializing Flow in a repo, configuring .agents, scaffolding OKF knowledge bundles, or creating first project context files.

Author
cofin ↗
Repository
flow ↗
Licence
Apache-2.0
Last repository change
26.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
2
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.09.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Use when initializing Flow in a repo, configuring .agents, scaffolding OKF knowledge bundles, or creating first project context files.

Original author description

Use when initializing Flow in a repo, configuring .agents, scaffolding OKF knowledge bundles, or creating first project context files.

How it works

  1. Trigger
  2. Workflow
  3. Guardrails
  4. Output
  5. Validation
  6. Example
Original SKILL.md headings · 40 lines, 224 words
SKILL.md preview
---
name: flow-setup
description: "Use when initializing Flow in a repo, configuring .agents, scaffolding OKF knowledge bundles, or creating first project context files."
disable-model-invocation: true
---

# Flow Setup

<!-- lifecycle-ownership: owner=flow-setup; operations=setup -->

## Trigger

Use for `setup` only.

## Workflow

1. **Repository & Stack Detection**: Detect language, framework, canonical commands (`test`, `lint`, `typecheck`), and existing Flow configuration.
2. **Scaffold Hierarchical OKF Layout**: Initialize `.agents/bundles/index.md` (with `okf_version: "0.2"`). Create `product/product.md`, `product/tech-stack.md`, and `knowledge/workflow.md`; create `knowledge/patterns/<topic>.md` chapters and their directory only when repository evidence supports them.
3. **Standalone Project Skills Option**: Ask whether to install a standalone,
   project-local Flow dependency closure into `.agents/skills/`. This prompt
   defaults to skip and installation requires explicit opt-in. Treat the
   standalone copy as an alternative to the global plugin, not an overlay.
4. **Validation & State Write**: Verify bundle links and OKF frontmatter compliance, then write `.agents/setup-state.json` with `setup_status: complete`.

## Guardrails

- Preserve existing developer context; never overwrite custom blocks inside `<!-- project-customization: start -->`.
- Use the standalone installer for copy, update, conflict, and uninstall
  operations; never hand-copy or delete project skills.
- Preserve Git history and tag immutability.

## Output

Return the resolved layout, generated bundle files, and planning handoff command (`/flow:plan`).

## Validation

Confirm OKF frontmatter validity, directory link integrity, and
`.agents/setup-state.json` configuration. For a standalone install, also
confirm its contained dependency closure and exact managed-file hashes.

## Example

For a new repository, run setup to detect the Python uv stack, scaffold `.agents/bundles/` with hierarchical chapters, and initialize the setup state.
Files in this package (2)
  • SKILL.md 2 KB
  • agents/openai.yaml 1 KB

Versions

RepositoryScoreLicence
This page · cofin/flow100Apache-2.0
cofin/flow90Apache-2.0

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 441b832b5841 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100okf-wiki
    Builds an Open Knowledge Format (OKF) knowledge base from existing docs, notes, or a repo. Use to scaffold an OKF wiki.
  • 100okf
    Use when creating, editing, validating, or structuring Open Knowledge Format (OKF v0.2) bundle files (.agents/bundles/), YAML frontmatter, or hierarchical knowledge trees.
  • 100flow
    Use when a repository has .agents, when the user asks for Flow lifecycle routing, OKF bundle task tracking, spec-first planning, TDD implementation, sync/status, review, finish, archive, or /flow:* help.
  • 100open-knowledge-format
    Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the…
  • 100okf-maintain-knowledge
    OKF — Author, maintain, and consume Open Knowledge Format (OKF) knowledge bundles. Use when capturing project knowledge (services, APIs, schemas, decisions) into an OKF bundle, when updating one after code or docs change, or when a repository's OKF bundle should inform the task.…
  • 100okf
    Create, read, and maintain Open Knowledge Format documentation bundles in repositories. Use this skill when the user asks for /okf, OKF, Open Knowledge Format, docs-as-knowledge, reading project context from docs, reorganizing docs into an agent-readable bundle, updating…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.