Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@
"plugins": [
{
"name": "agentic-engineering",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, security, Go, Kubernetes, Flux, Talos, frontend and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "6.8.1",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "7.0.0",
"source": "./plugins/agentic-engineering"
},
{
Expand Down
4 changes: 2 additions & 2 deletions .github/plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@
"plugins": [
{
"name": "agentic-engineering",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, security, Go, Kubernetes, Flux, Talos, frontend and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "6.8.1",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "7.0.0",
"source": "./plugins/agentic-engineering"
},
{
Expand Down
10 changes: 8 additions & 2 deletions docs/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ A **skill** teaches an assistant a task. An **agent** gives it a specialized rol

| Plugin | Resources | Description |
|--------|-----------|-------------|
| [`agentic-engineering`](../plugins/agentic-engineering/) | `agent-improvement`, `agent-instructions`, `astro`, `codeql`, `conventional-release`, `dependabot`, `dependency-scanning`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `portfolio-maintenance`, `product-documentation`, `product-engineering`, `prototype`, `refactor`, `secret-scanning`, `self-improvement`, `siderolabs`, `test-driven-development`, `ways-of-working`, `web-design-guidelines`, `write-contributing`, `write-docs-introduction`, `write-readme` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `flux-operator-mcp`, `github-ghas-tools`, `siderolabs-docs` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, security, Go, Kubernetes, Flux, Talos, frontend and engineering-practice skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` |
| [`agentic-engineering`](../plugins/agentic-engineering/) | `agent-improvement`, `agent-instructions`, `autofix`, `code-review`, `codeql`, `context7-mcp`, `conventional-release`, `dependabot`, `dependency-scanning`, `find-skills`, `frontend-design`, `gh-cli`, `gh-stack`, `git-commit`, `github-actions-docs`, `github-actions-efficiency`, `github-actions-hardening`, `github-issues`, `gitops-cluster-debug`, `gitops-knowledge`, `gitops-tenant-onboarding`, `golang-pro`, `grilling`, `portfolio-maintenance`, `product-documentation`, `product-engineering`, `prototype`, `refactor`, `secret-scanning`, `self-improvement`, `siderolabs`, `stripe-best-practices`, `stripe-docs`, `svelte-core-bestpractices`, `test-driven-development`, `upgrade-stripe`, `ways-of-working`, `web-design-guidelines`, `write-contributing`, `write-docs-introduction`, `write-readme` (skills) · `agent-improver`, `agentic-engineer`, `flux-troubleshooter`, `portfolio-surveyor` (agents) · `context7`, `flux-operator-mcp`, `github`, `github-ghas-tools`, `siderolabs-docs`, `stripe`, `svelte` (MCP servers) | The autonomous engineering system for a whole repository portfolio, and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; operating, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments and engineering-practice skills; and the MCP servers they use. Configured by the consumer's `AGENTS.md` |
| [`vibe-coding`](../plugins/vibe-coding/) | `needs-stack-mapping`, `allowed-stack-guardrail`, `jargon-free-voice` (skills) · `vibe-coding-companion` (agent) | Build a product by conversation alone — plain-language companion agent + guardrailed needs-to-stack skills for people with no technical background |
| [`ksail`](../plugins/ksail/) | `ksail` (skill) · `ksail` (MCP server) | Create and operate Kubernetes clusters and GitOps workloads with the KSail CLI — needs `ksail` on `PATH`; PolyForm Shield licensed |

Expand All @@ -21,8 +21,10 @@ license file the plugin ships; keep both when you copy or redistribute those ski
|-------|--------|----------|---------|
| `agent-improvement` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
| `agent-instructions` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
| `astro` | `agentic-engineering` | astrolicious/agent-skills | MIT |
| `autofix` | `agentic-engineering` | coderabbitai/skills | MIT |
| `code-review` | `agentic-engineering` | coderabbitai/skills | MIT |
| `codeql` | `agentic-engineering` | github/awesome-copilot | MIT |
| `context7-mcp` | `agentic-engineering` | upstash/context7 | MIT |
| `conventional-release` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
| `dependabot` | `agentic-engineering` | github/awesome-copilot | MIT |
| `dependency-scanning` | `agentic-engineering` | github/copilot-advanced-security-plugin | MIT |
Expand All @@ -49,7 +51,11 @@ license file the plugin ships; keep both when you copy or redistribute those ski
| `secret-scanning` | `agentic-engineering` | github/awesome-copilot | MIT |
| `self-improvement` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
| `siderolabs` | `agentic-engineering` | siderolabs/docs | Apache-2.0 |
| `stripe-best-practices` | `agentic-engineering` | stripe/ai | MIT |
| `stripe-docs` | `agentic-engineering` | stripe/ai | MIT |
| `svelte-core-bestpractices` | `agentic-engineering` | sveltejs/ai-tools | MIT |
| `test-driven-development` | `agentic-engineering` | obra/superpowers | MIT |
| `upgrade-stripe` | `agentic-engineering` | stripe/ai | MIT |
| `ways-of-working` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
| `web-design-guidelines` | `agentic-engineering` | vercel-labs/agent-skills | MIT |
| `write-contributing` | `agentic-engineering` | devantler-tech/agent-plugins | Apache-2.0 |
Expand Down
29 changes: 21 additions & 8 deletions docs/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,19 +33,30 @@ armed, or with a schedule pointing at an entrypoint that no longer resolves. The
## MCP servers

A plugin may bundle [MCP](https://modelcontextprotocol.io) servers as well as skills. The
[`agentic-engineering`](../plugins/agentic-engineering/) plugin bundles three, authored once in its
[`agentic-engineering`](../plugins/agentic-engineering/) plugin bundles seven, authored once in its
[`.mcp.json`](../plugins/agentic-engineering/.mcp.json) (`mcpServers` map), and the
[`ksail`](../plugins/ksail/) plugin bundles the KSail server, which needs `ksail` on `PATH`:

| Server | What it connects to | Needs |
|---|---|---|
| `context7` | Upstash's Context7: current documentation and code examples for libraries and frameworks, read-only | Nothing; it works without an account |
| `flux-operator-mcp` | A live cluster's Flux resources, read-only (`serve --read-only`), for the `gitops-cluster-debug` skill and the `flux-troubleshooter` agent | The `flux-operator-mcp` binary, a POSIX `sh`, and cluster access through `KUBECONFIG` (default `~/.kube/config`) |
| `github` | GitHub's everyday tools: repositories, issues, pull requests, Actions, labels and projects, read, and issue, label, comment, branch, new pull request and project writes; merging, pull request edits, reviews, file writes and workflow runs are excluded | A GitHub sign-in; see below |
| `github-ghas-tools` | GitHub's security tools, read-only (`X-MCP-Readonly`): alerts, advisories and dependency vulnerability lookups | A GitHub sign-in; see below |
| `siderolabs-docs` | Sidero Labs' search of the Talos Linux and Omni documentation | Nothing; it is public |

`siderolabs-docs` also offers a `submit_feedback` tool, which sends a report to Sidero Labs. With
the other two servers held read-only, it is the only tool among these servers that writes anywhere;
deny it in your tool permissions if your agents must not contact third parties.
| `stripe` | Stripe's hosted server at `https://mcp.stripe.com`: Stripe documentation, reads and writes on your Stripe account, analytics and money movement | A Stripe sign-in through OAuth |
| `svelte` | The Svelte team's hosted server at `https://mcp.svelte.dev/mcp`: Svelte 5 and SvelteKit documentation, the `svelte-autofixer` and playground links, all read-only | Nothing; it is public |

Every server but `flux-operator-mcp` is hosted by a third party, so every call to one, including a
documentation search, reaches that service. If your agents must not contact a third party, disable
its server in your tool's MCP settings; denying single tools does not stop the connection. Among
the servers you keep, `github` and `stripe` can change things: `github` writes to GitHub as the
signed-in account, and `stripe` writes to your Stripe account and can move money. The
`siderolabs-docs` `submit_feedback` and `stripe` `send_stripe_feedback` tools send reports to Sidero
Labs and Stripe. The Svelte autofixer and playground tools send the code they are given to Svelte's
service, and the playground link carries that code. The
[plugin README](../plugins/agentic-engineering/README.md#bundled-mcp-servers) covers each server's
sign-in and what to deny.

How each tool consumes the file differs (per [ADR 0001](../docs/adr/0001-bundling-mcp-servers-and-custom-agents.md)):

Expand Down Expand Up @@ -78,9 +89,11 @@ context in that kubeconfig, starting at the current one, because its read-only
[Flux MCP docs](https://fluxcd.control-plane.io/operator/mcp/) for read-only mode and remote
transport.

`github-ghas-tools` is GitHub's remote MCP server limited to its read-only security toolsets, so
nothing needs installing. Copilot CLI and VS Code sign in to it with your Copilot session; Claude
Code runs the plugin's `headersHelper`, which sends your GitHub CLI login token. The
`github` and `github-ghas-tools` are both GitHub's remote MCP server, so nothing needs installing:
`github` with its everyday toolsets and most write tools, `github-ghas-tools` on the read-only
endpoint with only its security toolsets. Copilot CLI and VS Code sign in to them with your Copilot
session; Claude Code
runs the plugin's `headersHelper`, which sends your GitHub CLI login token. The
[plugin README](../plugins/agentic-engineering/README.md#bundled-mcp-servers) covers sign-in for
each tool and the optional narrower token.

Expand Down
14 changes: 11 additions & 3 deletions plugins/agentic-engineering/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "agentic-engineering",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, security, Go, Kubernetes, Flux, Talos, frontend and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "6.8.1",
"description": "The autonomous engineering system for repository portfolios and everything its agents need — engineer, read-only surveyor, meta-engineer and Flux troubleshooter agents; portfolio, product, spend and improvement workflows; GitHub, CodeRabbit review, security, library documentation, Go, Kubernetes, Flux, Talos, SvelteKit frontend, Stripe payments and engineering-practice skills; and the MCP servers they use; configured by the consumer AGENTS.md",
"version": "7.0.0",
"author": {
"name": "devantler-tech",
"url": "https://github.com/devantler-tech"
Expand All @@ -27,7 +27,15 @@
"gitops",
"flux",
"talos",
"mcp",
"svelte",
"sveltekit",
"frontend",
"mcp"
"coderabbit",
"code-review",
"context7",
"documentation",
"stripe",
"payments"
]
}
23 changes: 22 additions & 1 deletion plugins/agentic-engineering/.mcp.json
Original file line number Diff line number Diff line change
@@ -1,15 +1,28 @@
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"flux-operator-mcp": {
"command": "sh",
"args": [
"-c",
"[ -n \"$KUBECONFIG\" ] || { [ -n \"$HOME\" ] || { echo 'flux-operator-mcp: set KUBECONFIG or HOME' >&2; exit 1; }; KUBECONFIG=\"$HOME/.kube/config\"; }; export KUBECONFIG; exec flux-operator-mcp serve --read-only"
]
},
"github-ghas-tools": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
Comment thread
devantler marked this conversation as resolved.
Resolved
"headers": {
"X-MCP-Toolsets": "context,repos,issues,pull_requests,users,actions,labels,projects",
"X-MCP-Exclude-Tools": "merge_pull_request,create_repository,fork_repository,push_files,create_or_update_file,delete_file,update_pull_request_branch,update_pull_request,pull_request_review_write,add_comment_to_pending_review,actions_run_trigger"
},
"headersHelper": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/github-mcp-headers.sh\" \"${CLAUDE_PLUGIN_DATA}\""
Comment thread
devantler marked this conversation as resolved.
Resolved
},
"github-ghas-tools": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/readonly",
"headers": {
"X-MCP-Toolsets": "code_security,secret_protection,security_advisories,dependabot",
"X-MCP-Readonly": "true"
Expand All @@ -19,6 +32,14 @@
"siderolabs-docs": {
"type": "http",
"url": "https://docs.siderolabs.com/mcp"
},
"stripe": {
"type": "http",
"url": "https://mcp.stripe.com"
},
"svelte": {
"type": "http",
"url": "https://mcp.svelte.dev/mcp"
}
}
}
69 changes: 69 additions & 0 deletions plugins/agentic-engineering/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,74 @@
# Changelog — `agentic-engineering`

## 7.0.0 — 2026-11-04

SvelteKit replaces Astro as the frontend stack the agents are equipped for, and the plugin now
carries the GitHub, CodeRabbit, Context7 and Stripe tooling the agents otherwise needed separate
plugins or connectors for.

**Removed** — `astro`, previously from `https://github.com/astrolicious/agent-skills`. The
portfolio this plugin serves builds its sites with SvelteKit.

**Added — skills**

- `svelte-core-bestpractices` from `https://github.com/sveltejs/ai-tools` at
`refs/tags/@sveltejs/mcp@0.1.30`: the Svelte team's guidance on writing modern Svelte 5 code.
- `code-review` and `autofix` from `https://github.com/coderabbitai/skills` at `refs/tags/v1.1.1`:
a local review with the CodeRabbit CLI, and working through CodeRabbit's review threads on a pull
request.
- `context7-mcp` from `https://github.com/upstash/context7` at
`refs/tags/@upstash/context7-mcp@4.5.0`: looking up current library documentation through the
`context7` server.
- `stripe-best-practices`, `stripe-docs` and `upgrade-stripe` from `https://github.com/stripe/ai`
at `refs/heads/main`: Stripe integration guidance, Stripe's documentation through the Stripe CLI,
and API and SDK upgrades.

**Added — MCP servers**

- `svelte`, the Svelte team's hosted server at `https://mcp.svelte.dev/mcp`: Svelte 5 and SvelteKit
documentation, the `svelte-autofixer` and playground links, all read-only and needing no
sign-in. The hosted server is used instead of `npx -y @sveltejs/mcp`, so nothing is downloaded or
run locally. The autofixer and playground tools send the code they are given to Svelte's service,
and the playground link carries that code.
- `github`, GitHub's remote server with the `context`, `repos`, `issues`, `pull_requests`, `users`,
`actions`, `labels` and `projects` toolsets, signed in like `github-ghas-tools`. **It can write to
GitHub as the signed-in account**: issues and sub-issues, labels, comments and replies, branches,
new pull requests and project items. Merging, editing or promoting a pull request, writing or
resolving reviews, updating a pull request branch, creating or forking repositories, writing files
and running workflows are excluded, so they stay on `gh` and git, where a consumer's rules apply.
- `context7`, Upstash's hosted Context7 server at `https://mcp.context7.com/mcp`, read-only and
needing no account.
- `stripe`, Stripe's hosted server at `https://mcp.stripe.com`, signed in through OAuth. **Every
tool is offered, including `stripe_api_write` and the Treasury tools that move money**; grant only
the accounts and permissions your agents need on Stripe's consent page.

Not bundled: the Svelte plugin's `svelte-code-writer` skill, which drives the same tools through
`npx`, and its `svelte-mcp-feedback` skill, which files reports with the Svelte team; CodeRabbit's
agent and slash command, which come only with its plugin; Context7's `find-docs` and `context7-cli`
skills, which run its CLI through `npx`; and Stripe's paying, purchasing and payee-lookup skills, its
Connect, Metronome and Stripe Apps skills and its plugin's hooks.

**Changed**

- `github-ghas-tools` now uses GitHub's read-only endpoint, `https://api.githubcopilot.com/mcp/readonly`.
Claude Code loads only the first of two plugin servers with the same URL, so sharing `github`'s
URL would have dropped it; `validate-manifests.sh` now refuses two servers with one URL.
- Every hosted server reaches its third party on every call, so the documentation now says to
disable a server, not deny single tools, when your agents must not contact that party.

### Upgrading to 7.0.0

If your agents still work on Astro sites, install the `astro` skill from its upstream yourself, at
user scope and for your agent, for example
`gh skill install astrolicious/agent-skills astro --scope user --agent claude-code`. A
non-interactive install otherwise goes to the current project only, and for GitHub Copilot.

The new `github` and `stripe` servers can change things. Before your agents' next run, decide what
they may do: deny `github` or `stripe` tools in your tool permissions, or disable either server,
where the plugin should not write. Sign in to `stripe` through `/mcp` in Claude Code when you want
it; until then it reports that it needs authentication. If you used CodeRabbit's, Context7's or
Stripe's own plugins or connectors only for what this release bundles, you can remove them.

## 6.8.1 — 2026-11-04

**Fixed** — the bundled Flux tooling now works out of the box:
Expand Down
Loading
Loading