flow-skills

Agent skills for Flow, a bioinformatics platform built by Goodwright. This repository is a plugin marketplace; today it ships one plugin, flowbio, which lets an AI agent query Flow's REST API — and upload data — on your behalf.

What flowbio does

The plugin's README says what it does, what it runs and sends, and when it prompts for permission.

Getting a Flow API key (optional)

See Getting a Flow API key in the plugin's README.

Install — Claude Code (recommended)

This repo is a Claude Code plugin marketplace. Inside Claude Code:

/plugin marketplace add goodwright/flow-skills
/plugin install flowbio@flow-skills

To pick up new releases later, run /plugin marketplace update.

Install — other agents

The skill itself is just a directory of Markdown files following Anthropic's Agent Skill format. Any agent harness that loads skills from a directory can use it directly. Clone the repo and point your harness at plugins/flowbio/skills/flow-assistant/:

git clone https://github.com/goodwright/flow-skills.git
# Then either symlink or copy plugins/flowbio/skills/flow-assistant/ into wherever
# your agent loads skills from. For example, for Claude Code's standalone
# mode:
mkdir -p ~/.claude/skills
ln -s "$(pwd)/flow-skills/plugins/flowbio/skills/flow-assistant" ~/.claude/skills/flow-assistant

For agents that consume SKILL.md directly (Codex, Gemini CLI, Copilot CLI, etc.), see your harness's documentation for the skill load path. The skill's contract is the YAML frontmatter in SKILL.md plus the supporting files it references — no harness-specific glue.

Versioning

The canonical version lives in plugins/flowbio/.claude-plugin/plugin.json. On each release, bump it and add the release to CHANGELOG.md.

The flowbio version the skill runs is pinned in one place, FLOWBIO_VERSION in plugins/flowbio/skills/flow-assistant/scripts/flow-cli. To move to a new flowbio, change it there.

Contributing

Issues and PRs welcome at https://github.com/goodwright/flow-skills. For changes to the skill itself, also update an eval (or add a new one) that demonstrates the new behaviour, and add a CHANGELOG.md entry under the next version (or [Unreleased]) for anything a user would notice.

Skills in unpublished/ are kept for later work and are not part of any plugin, so no install picks them up.

The skill's allowed-tools pre-approves its read commands, and only matches them run by the launcher's full path. In a non-interactive run (claude -p), Claude Code won't load a skill that grants itself tools unless Skill(flowbio:flow-assistant) is allowed, so the eval runner allows it.

License

MIT — © 2026 Goodwright.