Skip to content

Distribution Guide

How to publish and disseminate omics-skills across registries, marketplaces, and ecosystems.

Overview

The Agent Skills open standard (released December 2025) enables cross-platform skill portability. Your skills will work across Claude Code, Codex CLI, ChatGPT, and other platforms that adopt the standard.

Good news: Your repository already follows the Agent Skills specification! Each skill has a SKILL.md with YAML frontmatter, making it ready for distribution.

Distribution Channels

URL: https://claude.com/docs/plugins/submit

Purpose: Public plugin directory for Cowork and Claude Code. A plugin can bundle skills, agents, MCP connectors, commands, and hooks into one installable package.

Repository status: This repository includes: - .claude-plugin/plugin.json — plugin metadata - .claude-plugin/marketplace.json — marketplace catalog - agents/ and skills/ at the plugin root, which Claude Code discovers as plugin components

Validate before submitting: 

claude plugin validate .
claude plugin validate --strict .

Test direct install from GitHub: 

claude plugin marketplace add fmschulz/omics-skills
claude plugin install omics-skills@omics-skills

Submit for review: - Claude.ai: https://claude.ai/settings/plugins/submit - Console: https://platform.claude.com/plugins/submit

Use the public GitHub repository URL, https://github.com/fmschulz/omics-skills, when submitting. Anthropic's review pipeline runs claude plugin validate plus automated screening. Approved community plugins are added to the public Claude community catalog and updates are picked up from the GitHub repository automatically.

2. Official Repositories

URL: github.com/anthropics/skills

Purpose: Official Anthropic-maintained public repository for Agent Skills

How to Submit: 1. Fork the repository 2. Add your skill(s) to the skills/ directory 3. Follow their structure (see existing skills as examples) 4. Test your skill with Claude Code 5. Submit a pull request with clear documentation

Benefits: - Official Anthropic visibility - Auto-indexed by Claude Code plugin marketplace - High trust/credibility - Direct user installation via /plugin install skill-name

What to Submit: - Individual skills (one PR per skill, or related skills together) - Start with high-impact skills: bio-logic, scientific-writing, beautiful-data-viz - Consider submitting agent-agnostic skills first

OpenAI Codex Skills Repository

URL: github.com/openai/skills

Purpose: Skills Catalog for Codex CLI

How to Submit: 1. Fork the repository 2. Add skill to appropriate category 3. Follow their contribution guidelines 4. Submit pull request

Benefits: - Codex CLI users can discover your skills - Cross-platform exposure (Agent Skills standard)

3. Community Marketplaces

SkillsMP (Skills Marketplace) ⭐

URL: skillsmp.com

Purpose: Community-driven aggregator with 71,000+ skills

How to Submit: - Automatic indexing: Push your skills to GitHub - SkillsMP automatically indexes public repositories - Manual submission: Contact via their site or submit your GitHub repo URL - GitHub tag: Add topic tags like claude-skills, agent-skills, bioinformatics

Benefits: - Largest skill aggregator - Compatible with Claude Code, Codex CLI, ChatGPT - Search and discovery features - No approval process needed

Action: 

# Add GitHub topics to your repo
# Go to: https://github.com/fmschulz/omics-skills
# Add topics: claude-skills, agent-skills, bioinformatics,
#             computational-biology, scientific-writing, data-visualization

SkillHub

URL: skillhub.club

Purpose: AI-evaluated Claude skills marketplace (7,000+ skills)

How to Submit: - Create a SKILL.md file, push to GitHub, and it's automatically indexed - Uses AI evaluation for quality scoring - Compatible with Claude Code, Codex CLI, Gemini CLI, OpenCode

Benefits: - Quality scoring helps users find best skills - Multi-platform support - Automatic indexing

MCP Market

URL: mcpmarket.com/tools/skills

Purpose: Agent Skills directory for Claude.ai, Claude Code, Codex

How to Submit: - Submit via their website - Provide GitHub repository URL - Include skill descriptions and categories

4. Your GitHub Repository

Make Your Repo Discoverable

Current URL: github.com/fmschulz/omics-skills

Optimize for Discovery:

  1. Add GitHub Topics: 

    claude-skills, agent-skills, claude-code, codex-cli,
bioinformatics, computational-biology, omics,
scientific-writing, data-visualization, genomics

  2. Complete Repository Description: 

    4 expert agents and 35 specialized skills for bioinformatics,
scientific writing, and data visualization. Compatible with
Claude Code and Codex CLI.

  3. Keep README badges accurate if used:

  4. Agent Skills standard badge
  5. Compatible platforms badge

  6. License badge

  7. Maintain GitHub Pages:

  8. Publish the MkDocs documentation site
  9. Keep installation, skill catalog, and routing pages current

Repository Structure for Marketplaces

Marketplaces look for: - ✅ SKILL.md files with YAML frontmatter (you have this) - ✅ Clear directory structure (you have this) - ✅ README.md documentation (you have this) - ✅ LICENSE file in the repository root - ✅ GitHub topics/tags (need to add)

5. Community Listings

Awesome Lists

awesome-claude-skills: - github.com/travisvn/awesome-claude-skills - github.com/ComposioHQ/awesome-claude-skills

How to Submit: 1. Fork the repository 2. Add your repository to appropriate category 3. Submit pull request with description

Benefits: - Community visibility - Curated lists are often referenced - Good for specialized domains (bioinformatics)

Reddit & Forums

Communities: - r/ClaudeAI - r/Bioinformatics - Anthropic Discord - Bioinformatics forums

How to Share: - Create announcement post - Highlight unique value (first comprehensive omics skills collection) - Include installation instructions - Request feedback

Step-by-Step Action Plan

Phase 1: Immediate Actions (1-2 hours)

  1. Add GitHub Topics: 

    # Go to: https://github.com/fmschulz/omics-skills
# Click "About" gear icon
# Add topics: claude-skills, agent-skills, bioinformatics,
#             computational-biology, scientific-writing, etc.

  2. Keep the root LICENSE file current.

  3. Refresh README badges only when they are maintained: 

    [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-blue)](https://agentskills.io)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green)](https://code.claude.com)
[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-Compatible-green)](https://developers.openai.com/codex)

  4. Push Updates: 

    git add .
git commit -m "docs: refresh distribution metadata"
git push

Phase 2: Marketplace Submissions (2-3 days)

  1. Wait for Automatic Indexing:
  2. SkillsMP will auto-index within 24-48 hours
  3. SkillHub will auto-index your repo

  4. No action needed except GitHub topics

  5. Submit to Anthropic Official Repo:

  6. Fork github.com/anthropics/skills
  7. Choose 3-5 best skills to submit initially:
    • bio-logic (universal reasoning skill)
    • scientific-writing (manuscript generation)
    • beautiful-data-viz (publication figures)
    • notebooks (marimo-first notebooks; Jupyter supported)
    • bio-reads-qc-mapping (sequencing data QC)
  8. Add to skills/ directory
  9. Submit pull request with description

  10. Reference your full repository for more skills

  11. Submit to OpenAI Codex:

  12. Fork github.com/openai/skills
  13. Add 2-3 representative skills

  14. Submit pull request

  15. Submit to MCP Market:

  16. Visit mcpmarket.com
  17. Submit repository URL
  18. Add descriptions and categories

Phase 3: Community Outreach (1 week)

  1. Awesome Lists:
  2. Submit to awesome-claude-skills

  3. Create specialized awesome-bioinformatics-ai-skills?

  4. Social/Community:

  5. Reddit announcement (r/ClaudeAI, r/Bioinformatics)
  6. Anthropic Discord announcement
  7. Bioinformatics Slack/Discord groups

  8. Twitter/X announcement with hashtags: 

    #ClaudeCode #AgentSkills #Bioinformatics #ComputationalBiology

  9. Blog Post/Article:

  10. Write about creating comprehensive skill collection
  11. Share on Medium, Dev.to, or your blog
  12. Technical walkthrough of skill development
  13. Use case examples

Phase 4: Ongoing Maintenance

  1. Monitor Issues:
  2. Watch for GitHub issues
  3. Respond to user questions

  4. Accept community contributions

  5. Update Skills:

  6. Keep skills current with tool updates
  7. Add new skills based on user requests

  8. Improve documentation based on feedback

  9. Track Adoption:

  10. GitHub stars/forks
  11. Clone counts (if visible)
  12. User feedback and issues

Submission Templates

Release Process

Use GitHub Releases as the canonical release-note surface. Do not keep a separate root CHANGELOG.md unless the project later needs generated offline release history.

For each release:

  1. Choose a semantic version tag such as v1.0.0.
  2. Add human-written release notes at .github/releases/vX.Y.Z.md.
  3. Commit and push the release-ready docs, skills, agents, catalog, and tests.
  4. Create an annotated tag from the pushed commit.
  5. Push the tag. .github/workflows/release.yml publishes the GitHub Release from .github/releases/<tag>.md.

Release notes should cover: - major user-facing changes - agent and skill coverage - installation or compatibility notes - validation commands run before release 6. Keep the README version badge pointed at the repository releases page.

Pull Request Template (for Anthropic/OpenAI repos)

## Skill Submission: [Skill Name]

**Description:** [One-line description]

**Domain:** Bioinformatics / Scientific Writing / Data Visualization

**Use Cases:**
- [Use case 1]
- [Use case 2]

**Tested With:**
- Claude Code: ✓
- Codex CLI: ✓

**Additional Notes:**
This skill is part of the omics-skills collection available at:
https://github.com/fmschulz/omics-skills

The collection includes 35 specialized skills and 4 expert agents for
computational biology workflows.

Reddit Announcement Template

Title: [Release] Omics Skills - Agent Skills for Bioinformatics with Claude Code/Codex

I've created a comprehensive collection of Agent Skills for computational biology:

**What it includes:**
- 4 expert agents (omics-scientist, literature-expert, science-writer, dataviz-artist)
- 35 specialized skills (reads QC, assembly, annotation, phylogenomics, literature, writing, visualization, etc.)
- Complete installation system (one-command install)
- Works with Claude Code and Codex CLI

**Use cases:**
- Genome/metagenome assembly and annotation
- Scientific manuscript writing with literature search
- Publication-quality data visualization

**Repository:** https://github.com/fmschulz/omics-skills

**Installation:**
```bash
git clone https://github.com/fmschulz/omics-skills.git
cd omics-skills
make install

Feedback and contributions welcome! ```

Expected Outcomes

Short-term (1-2 weeks)

  • Automatic indexing by SkillsMP and SkillHub
  • GitHub stars and community interest
  • Initial user feedback

Medium-term (1-2 months)

  • Official repo acceptance (Anthropic/OpenAI)
  • Integration with Claude Code plugin marketplace
  • Community contributions

Long-term (3-6 months)

  • Established as go-to bioinformatics skills collection
  • Multiple contributors
  • Adoption in academic/research settings

Marketing Points

Unique Value Propositions:

  1. First Comprehensive Bioinformatics Collection
  2. No other skill repository covers end-to-end omics workflows

  3. From raw reads to publication-ready figures

  4. Three Expert Agents

  5. Not just skills - complete agent personas that orchestrate workflows

  6. Clear separation: omics-scientist, science-writer, dataviz-artist

  7. Production-Ready

  8. Battle-tested structure
  9. Comprehensive documentation
  10. Installation system included

  11. Quality gates and validation

  12. Cross-Platform

  13. Claude Code
  14. Codex CLI

  15. Follows Agent Skills open standard

  16. Academic/Research Focus

  17. Literature-backed (summaries/ directories with papers)
  18. Best practices from scientific community
  19. Reproducibility emphasis

Resources

Official Documentation

Community Resources

Tools

Questions to Consider

  1. Licensing: Choose appropriate license (MIT, Apache 2.0, GPL)
  2. Contribution Guidelines: Accept external contributions?
  3. Maintenance: Who maintains? How often update?
  4. Versioning: Use semantic versioning for skills?
  5. Support: How to provide user support? (GitHub issues, Discord, etc.)

Next Steps Checklist

  • Add GitHub topics to repository
  • Confirm root LICENSE file is current
  • Refresh README badges only if they remain accurate
  • Push updates to GitHub
  • Wait for auto-indexing (SkillsMP, SkillHub)
  • Submit to Anthropic skills repository
  • Submit to OpenAI Codex skills
  • Submit to MCP Market
  • Post announcement on Reddit
  • Share on Twitter/X
  • Submit to awesome-claude-skills lists
  • Write blog post/article
  • Monitor and respond to feedback

Keep this page current when the agent or skill counts change.