Skip to content

galaxyproject/skills

Repository files navigation

Galactic skills

This is a space for depositing various helpful artifacts (skills, commands, etc.) for various agentic things like Claude Code or Gemini Code Agent. The idea is that by iterating over this we will create a robust set of community curated "skills" that would ultimately create guardrails preventing LLMs from doing crazy 💩 and ensuring best practices. Should probably be called Intergalactic LLM-taming commision (ILT).

This was not written by Claude.

this is complementary to https://github.com/galaxyproject/galaxy-mcp


What Are Skills?

Skills are structured instructions that help AI agents work effectively with Galaxy development. They provide:

  • Best practices - The right way to build Galaxy tools, workflows, and content
  • Patterns - Common solutions to common problems
  • Examples - Concrete references to learn from
  • Guardrails - Preventing common mistakes

Important: This repo is for developers building Galaxy infrastructure. End-user analysis should happen in Galaxy itself to leverage its reproducibility and tracking features.

Skills vs MCP

Repository Purpose Use For
skills (this repo) Knowledge - How to build things well Tool development, workflow conversion, content creation
galaxy-mcp Capabilities - Interact with Galaxy programmatically Testing, automation, CI/CD

Use both together for best results.


Installation & Usage

Claude Code (Native Support)

Skills are automatically available. Just clone this repo into your workspace or add to .claude/skills/:

# Personal skills (available in all projects)
cd ~/.claude/skills
git clone https://github.com/galaxyproject/skills galaxy

# Project skills (specific to one project)
cd your-project/.claude/skills
git clone https://github.com/galaxyproject/skills galaxy

Claude will automatically discover and use skills when relevant.

Windsurf / Cursor / Aider (via openskills)

# Install openskills
npm i -g openskills

# Install Galaxy skills
openskills install galaxyproject/skills

# Load a specific skill when needed
openskills read tool-updates

Any Agent (Manual)

Clone this repo into your workspace and reference skills in your prompts:

git clone https://github.com/galaxyproject/skills

The LLM can read skill files directly from the workspace.


Available Skills

Tool Development

tool-dev

Create and update Galaxy tool wrappers.

  • creation/ - Create new tool wrappers from scratch or Nextflow
  • updates/ - Update existing tools to new versions
  • shared/ - XML structure, testing, help formatting
  • Router SKILL.md directs to appropriate sub-skill

Content

hub-news-posts

Write news posts for the Galaxy Project website (galaxyproject.org).

  • Frontmatter templates
  • Image handling
  • Vega charts
  • Styled tables

Conversion

nf-to-galaxy

Convert Nextflow processes and workflows to Galaxy tools and workflows.

  • Process → Tool XML
  • Container → bioconda mapping
  • Workflow → .ga files
  • Test with planemo and galaxy-mcp

Integration

galaxy-integration

Test tools and workflows on Galaxy instances.

  • Tool checking scripts
  • Workflow testing examples
  • Galaxy instance integration

Repository Structure

skills/
├── README.md                    # This file
├── CONTRIBUTING.md              # How to add new skills
├── AGENTS.md                    # Agent routing instructions
│
├── tool-dev/                    # ✅ Galaxy tool development
│   ├── SKILL.md                # Router to creation/ or updates/
│   ├── creation/               # Create new tools
│   ├── updates/                # Update existing tools
│   └── shared/                 # XML, testing, help references
│
├── hub-news-posts/              # ✅ Galaxy Hub posts
│
├── nf-to-galaxy/                # ✅ Nextflow → Galaxy conversion
│
└── galaxy-integration/          # ✅ Galaxy instance testing

Contributing

We welcome contributions! See CONTRIBUTING.md for:

  • How to create a new skill
  • Skill structure and format
  • Testing and validation
  • Submission guidelines

Examples

Updating a Galaxy Tool

User: "Update the ncbi-datasets tool to version 18.13.0"

AI: [Loads tool-updates skill]
    [Follows workflow: research upstream → update version → fix bugs → test]
    [Uses planemo for validation]

Converting Nextflow to Galaxy

User: "Convert this Nextflow process to a Galaxy tool"

AI: [Loads nf-to-galaxy skill]
    [Maps container → bioconda package]
    [Generates Galaxy tool XML]
    [Tests with planemo lint]
    [Optionally tests on Galaxy instance via galaxy-mcp]

Related Projects

  • galaxy-mcp - MCP server for Galaxy interaction
  • planemo - Galaxy tool development toolkit
  • Galaxy - Main Galaxy platform
  • IWC - Intergalactic Workflow Commission

License

MIT

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •