{"id":50902077,"url":"https://github.com/alexmond/alexmskills","last_synced_at":"2026-06-16T03:32:24.804Z","repository":{"id":364293134,"uuid":"1266734057","full_name":"alexmond/alexmskills","owner":"alexmond","description":"A curated Claude Code plugin marketplace of reusable, self-improving skills and agents — each an independently versioned plugin.","archived":false,"fork":false,"pushed_at":"2026-06-12T11:56:37.000Z","size":173,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T13:25:37.734Z","etag":null,"topics":["ai-agents","anthropic","automation","claude","claude-code","developer-tools","marketplace","plugins","skills"],"latest_commit_sha":null,"homepage":"https://www.alexmond.org/alexmskills/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexmond.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T22:49:51.000Z","updated_at":"2026-06-12T11:56:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alexmond/alexmskills","commit_stats":null,"previous_names":["alexmond/alexmskills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/alexmond/alexmskills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmond%2Falexmskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmond%2Falexmskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmond%2Falexmskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmond%2Falexmskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexmond","download_url":"https://codeload.github.com/alexmond/alexmskills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmond%2Falexmskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34390052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","anthropic","automation","claude","claude-code","developer-tools","marketplace","plugins","skills"],"created_at":"2026-06-16T03:32:23.407Z","updated_at":"2026-06-16T03:32:24.796Z","avatar_url":"https://github.com/alexmond.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# alexmskills\n\n[![Validate Marketplace](https://github.com/alexmond/alexmskills/actions/workflows/validate.yml/badge.svg)](https://github.com/alexmond/alexmskills/actions/workflows/validate.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Docs](https://img.shields.io/badge/docs-alexmond.org-informational)](https://www.alexmond.org/alexmskills/)\n\nA curated **[Claude Code](https://code.claude.com) plugin marketplace** of reusable, self-improving\nskills and agents. Each skill is packaged as an **independently versioned plugin**, so you install and\nupdate exactly what you need.\n\nThe emphasis is on **self-learning** tooling — skills that get better at *your* repo over time:\na CLAUDE.md that prunes and graduates its own decisions, a delivery crew that re-tiers its roles from\nrun history, a brainstorm panel that learns which experts your work needs, and a learn-on-failure hook\nthat captures every multi-cycle debugging detour.\n\n## Catalog\n\n| Plugin | Category | Version | What it does |\n|---|---|---|---|\n| [`evolving-claude-md`](plugins/evolving-claude-md) | self-learning | 1.0.0 | Turns CLAUDE.md into a living Decisions \u0026 Learnings log that prunes, graduates, and archives itself via three hooks. |\n| [`dev-crew`](plugins/dev-crew) | self-learning | 1.1.0 | A self-evolving delivery crew that composes a task-fit roster (like a panel, but to *ship* a target) and runs it as a gated relay with machine-enforced phase gates + an escalation ladder; each role a subagent on its own tier. (architect → dev → qa → deployer is one example lineup.) |\n| [`brainstorm-panel`](plugins/brainstorm-panel) | self-learning | 1.1.0 | Assembles a task-fit panel of role-specialized agents (skeptic always seated), picks a coordination style, and runs a generate-critique-refine loop with an evolving seat registry. |\n| [`learn-on-failure`](plugins/learn-on-failure) | self-learning | 1.0.0 | Auto-saves a durable learning to project memory whenever a task takes more than one fix cycle. |\n| [`roles`](plugins/roles) | self-learning | 1.0.0 | A per-repo repository of evolving roles (.claude/roles/) usable solo via /roles:as, as dev-crew roles, brainstorm-panel seats, and research-sweep coverage roles; ships seed personas + a graduation-audit hook. |\n| [`implement-issue`](plugins/implement-issue) | workflow | 1.0.0 | Drives a GitHub issue from branch → implement → verify → PR with a guided workflow. |\n| [`maven-quality`](plugins/maven-quality) | workflow | 1.0.0 | Format, static-analysis, coverage, and pre-commit skills for Maven/Java projects (codestyle, precommit, jacoco). |\n| [`security-audit`](plugins/security-audit) | workflow | 1.0.0 | Scans a codebase for OWASP-style vulnerabilities (injection, path traversal, unsafe reflection/deserialization, secrets). |\n| [`review-agents`](plugins/review-agents) | review | 1.0.0 | Read-only specialist subagents for code review, test running, and dependency/CVE auditing on lighter model tiers. |\n| [`research-sweep`](plugins/research-sweep) | research | 1.0.0 | Fans out independent research agents across distinct angles, then synthesizes and adversarially verifies. |\n\n## The Role System\n\nFour of the plugins form **one system**: a shared substrate of **evolving roles** (`.claude/roles/`) and\nthree **orchestrators** that compose those roles task-fit and learn over time. One persona — say a\n`skeptic` or an `architect` — behaves the same whether it's run solo, seated in a crew, on a panel, or in\na sweep, accumulating what it learns along the way.\n\n| Plugin | Role in the system | Verb |\n|---|---|---|\n| [`roles`](plugins/roles) | the shared substrate — evolving roles + solo invocation (`/roles:as \u003crole\u003e`) | — |\n| [`dev-crew`](plugins/dev-crew) | composes a roster and runs it as a **gated delivery relay** | **deliver** |\n| [`brainstorm-panel`](plugins/brainstorm-panel) | convenes a **multi-perspective panel** that critiques and converges | **decide** |\n| [`research-sweep`](plugins/research-sweep) | fans out **parallel coverage roles** then synthesizes + adversarially verifies | **discover** |\n\nThe three orchestrators **chain** — research *discovers* the facts, the panel *decides* what to do, the\ncrew *delivers* it — and they **share roles** (one `skeptic` is a panel seat, a crew adversarial check,\nand a research verifier). Each is fully usable on its own; co-installed, they share one evolving talent\npool. Full model: the\n**[Role System architecture](https://www.alexmond.org/alexmskills/role-system.html)**.\n\n## Install\n\nAdd the marketplace once:\n\n```text\n/plugin marketplace add alexmond/alexmskills\n```\n\nThen install what you want — copy-paste any of these:\n\n```text\n/plugin install evolving-claude-md@alexmskills\n/plugin install dev-crew@alexmskills\n/plugin install brainstorm-panel@alexmskills\n/plugin install learn-on-failure@alexmskills\n/plugin install roles@alexmskills\n/plugin install implement-issue@alexmskills\n/plugin install maven-quality@alexmskills\n/plugin install security-audit@alexmskills\n/plugin install review-agents@alexmskills\n/plugin install research-sweep@alexmskills\n```\n\nOr browse interactively with `/plugin` (Discover tab). After a maintainer pushes an update, refresh\nwith `/plugin marketplace update alexmskills`.\n\n### Try a plugin without installing\n\n```bash\nclaude --plugin-dir ./plugins/dev-crew\n```\n\n## Quick start\n\n- **`evolving-claude-md`** — open a repo and say *\"make CLAUDE.md evolve\"*. The plugin ships its own\n  hooks (audit on session start, lint on every CLAUDE.md edit, re-audit after compaction) — they\n  register automatically once the plugin is enabled.\n- **`dev-crew`** — *\"run the crew on this feature\"*. It composes a roster for the task; review it,\n  then it relays the roles, stopping at hard gates (QA fail, deploy). architect → dev → qa → deployer\n  is the typical code lineup — a data change or a doc gets a different one.\n- **`brainstorm-panel`** — *\"get a team on this and make it better\"*. It proposes a panel + a\n  coordination style for your sign-off, then runs the loop.\n- **`learn-on-failure`** — install it and forget it; it captures a learning whenever a task needed\n  more than one attempt.\n\n## Channels\n\nTwo marketplace channels ship from this one repo:\n\n- **stable** — `alexmskills` (`.claude-plugin/marketplace.json`): released, versioned plugins.\n- **beta** — `alexmskills-beta` ([`beta/`](beta)): unreleased / in-progress plugins. Opt in with a\n  `git-subdir` source (see [`beta/README.md`](beta/README.md)), then\n  `/plugin install \u003cname\u003e@alexmskills-beta`.\n\n```bash\nmake new-beta NAME=my-skill     # scaffold an unreleased plugin in the beta channel\nmake promote PLUGIN=my-skill    # move it into the stable catalog when it's ready\n```\n\n## Versioning\n\nClaude Code versions **per plugin**, not per skill. Each plugin carries a semantic `version` in its\n`plugin.json` and a matching entry in [`marketplace.json`](.claude-plugin/marketplace.json):\n\n- **Bump a version** to ship an update — users on a pinned version only receive it when the number\n  changes (commits alone don't trigger an update).\n- Tightly-coupled skills (e.g. `maven-quality`'s codestyle/precommit/jacoco) share one plugin and\n  version together; everything else is its own plugin so it can move independently.\n\n```bash\nmake bump PLUGIN=dev-crew VERSION=1.1.0   # updates plugin.json + marketplace.json together\n```\n\nRecord every version bump in [`CHANGELOG.md`](CHANGELOG.md).\n\n## Maintenance\n\n| Command | Purpose |\n| --- | --- |\n| `make validate` | Validate both channels + every plugin manifest (jq-based, no extra deps). Runs in CI. |\n| `make list` | Print the catalog (name, version, description). |\n| `make bump PLUGIN=\u003cname\u003e VERSION=\u003cx.y.z\u003e` | Bump a plugin's version in both manifests. |\n| `make new-beta NAME=\u003cname\u003e` | Scaffold a new plugin in the beta channel. |\n| `make promote PLUGIN=\u003cname\u003e` | Move a beta plugin into the stable catalog. |\n| `claude plugin tag --dry-run plugins/\u003cname\u003e` | Validate a plugin's `plugin.json` agrees with its marketplace entry. |\n| `claude plugin tag --push plugins/\u003cname\u003e` | Cut a `\u003cname\u003e--v\u003cversion\u003e` release tag. |\n\nCI (`.github/workflows/validate.yml`) validates the marketplace on every push and PR.\n\n## Documentation\n\nFull docs are published at **[alexmond.org/alexmskills](https://www.alexmond.org/alexmskills/)**\n(Antora component under [`docs/`](docs), aggregated by the\n[alexmond.github.io](https://github.com/alexmond/alexmond.github.io) site build).\n\n## Contributing\n\n1. Add a plugin under `plugins/\u003cname\u003e/` with a `.claude-plugin/plugin.json` and a `skills/` and/or\n   `agents/` directory.\n2. Register it in `.claude-plugin/marketplace.json` (under `plugins`).\n3. Run `make validate` — it must pass.\n4. Add a doc page under `docs/modules/ROOT/pages/` and link it in `nav.adoc`.\n\n## Provenance \u0026 attribution\n\nAll plugins in this marketplace are **original work by Alex Mondshain**, MIT-licensed — authorship is\nrecorded in each plugin's `plugin.json` (`author`) and the repo [LICENSE](LICENSE). One third-party\n**inspiration** is credited: the `roles` plugin's persona set was seeded by a public prompt thread from\n[@nahidulislam404](https://x.com/nahidulislam404) on X — the wording here is generalized and rewritten,\nbut that thread sparked the original set.\n\n## License\n\n[MIT](LICENSE) © Alex Mondshain\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmond%2Falexmskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexmond%2Falexmskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmond%2Falexmskills/lists"}