Maryann Skills Hub

Centralized AI skill library for Claude Code. Install skills with one command, auto-configure MCP servers and environment.

Install Skills

# Install a single skill
npx maryann-skills pr-reviewer --project

# Install all skills
npx maryann-skills --all --project

# Browse available skills
npx maryann-skills list

# View skill details
npx maryann-skills info prs-reviewer

Available Skills

| Skill | Description | MCP Required | |-------|-------------|:---:| | pr-reviewer | Bitbucket PR management — list, create, review, approve, merge | — | | prs-reviewer | Cross-check device PRS vs Maryann PRS (WebHID feasibility) | Confluence + Chrome | | post-mortem | Jira + Bitbucket post-mortem analysis and report generation | Jira-Bitbucket | | code-reviewer | Verify source code implements PRS review features | — | | ui-design-reviewer | Verify Figma designs match PRS review | Figma | | maryann-web-reviewer | Verify live web UI matches PRS review + optional Figma comparison | Chrome + Figma | | mcp-connector | Shared MCP servers (Confluence, Jira, Bitbucket) | — |

What Happens on Install

npx maryann-skills prs-reviewer --project
        │
        ├── .claude/skills/prs-reviewer/         ← skill files (symlink)
        ├── .claude/mcp-connectors/mcp-connector/ ← MCP servers (auto-installed, npm deps included)
        ├── .mcp.json                            ← MCP config (auto-generated)
        └── .env.example                         ← credentials template (auto-generated)

• Skills with MCP dependencies auto-install mcp-connector + run npm install
• .mcp.json is auto-generated/merged (won't overwrite existing entries)
• .env.example provides credential setup instructions

Architecture

maryann-skills-hub/
├── skills/                     # Each skill is a Git submodule
│   ├── pr-reviewer/            ← bitbucket.org/razersw/pr-review
│   ├── prs-reviewer/           ← bitbucket.org/razersw/prs-reviewer
│   ├── post-mortem/            ← bitbucket.org/razersw/post_mortem
│   ├── code-reviewer/          ← bitbucket.org/razersw/code-reviewer
│   ├── maryann-web-reviewer/   ← bitbucket.org/razersw/maryann-web-reviewer
│   ├── mcp-connector/          ← bitbucket.org/razersw/mcp-connector
│   ├── ui-design-reviewer/     ← bitbucket.org/razersw/ui-design-reviewer
│   └── _template/
├── cli/                        # npm CLI installer
├── registry/                   # Index builder (skills-index.json)
└── web/                        # Web catalog page (index.html)

Publishing Updates

When any skill submodule is updated:

npm version patch
npm publish --access public --//registry.npmjs.org/:_authToken=<token>

prepublishOnly automatically fetches latest submodules + rebuilds index.

Web Catalog

web/public/index.html is a standalone page that dynamically loads the skill list from npm CDN. Host it on any internal server — content auto-updates when npm is published.

Development

# Clone with submodules
git clone --recurse-submodules [email protected]:razersw/maryann-skills-hub.git

# Update all submodules to latest
git submodule update --remote

# Rebuild index
npm run build:index

# Test install locally
node cli/src/index.js --all --project

Contributing

See CONTRIBUTING.md for how to add new skills.