Agent plugins & skills

Ts.ED publishes an official agent plugin that teaches coding agents how to build Ts.ED v8 applications. It bundles:

• Skills covering the core packages of the framework (controllers, DI, models, validation, middlewares, exceptions, testing, OpenAPI, logger, MCP).
• The Ts.ED CLI MCP server, so the agent can scaffold projects and generate files with the same templates as tsed init and tsed generate.

The plugin lives in the Ts.ED repository and is distributed through four channels. Pick the one that matches your agent.

Channel	Skills	MCP server	Agents
Claude Code plugin marketplace	Yes	Yes	Claude Code (CLI, desktop, IDE extensions)
Codex plugin marketplace	Yes	Yes	Codex CLI and Codex in the ChatGPT desktop app
VS Code agent plugins	Yes	Yes	GitHub Copilot in VS Code
skills.sh	Yes	Manual	Cursor, Gemini CLI, Windsurf and others

TIP

The plugin complements the AGENTS.md template: AGENTS.md describes your project, the skills describe the framework.

Claude Code

Add the marketplace, then install the plugin:

claude plugin marketplace add tsedio/tsed --sparse .claude-plugin plugins
claude plugin install tsed@tsed

Or from inside a Claude Code session:

/plugin marketplace add tsedio/tsed
/plugin install tsed@tsed

--sparse limits the checkout to the marketplace files instead of cloning the whole framework monorepo.

To share the plugin with your team, declare it in the .claude/settings.json of your application:

{
  "extraKnownMarketplaces": {
    "tsed": {
      "source": {
        "source": "github",
        "repo": "tsedio/tsed"
      }
    }
  },
  "enabledPlugins": {
    "tsed@tsed": true
  }
}

Skills are namespaced by the plugin, for example /tsed:tsed-controllers. Claude also loads them on its own when a task matches their description.

VS Code extension

The Claude Code extension for VS Code has its own plugin manager:

1. Type /plugins in the prompt box to open Manage plugins.
2. On the Marketplaces tab, add tsedio/tsed.
3. On the Plugins tab, search for Ts.ED and click Install, then choose a scope: Install for you, Install for this project or Install locally.

Claude desktop app

The Claude desktop app manages its own plugins: a marketplace or a plugin added with the claude CLI isn't picked up by the desktop app, so install the plugin from the app itself.

1. Open Settings > Plugins, click Add, then choose to add a third-party marketplace and enter tsedio/tsed.
2. Select Ts.ED in the plugin browser and choose a scope: your user account, this project, or local-only.

The plugin browser is also available from a local session of the Code tab: click the + button next to the prompt box, then select Plugins > Add plugin.

Use + > Plugins > Manage plugins to enable, disable or uninstall the plugin later.

WARNING

The plugin browser is available in local and SSH sessions only. Cloud sessions and WSL sessions don't load the plugins installed on your machine.

Codex

Add the marketplace:

codex plugin marketplace add tsedio/tsed --sparse .agents/plugins --sparse plugins

Then install the tsed plugin from the plugin browser (/plugins in Codex) or from the shell:

codex plugin add tsed@tsed

Codex app

Codex in the ChatGPT desktop app installs plugins from the Plugins Directory, where each marketplace appears as a selectable source.

1. Add the Ts.ED marketplace with the Codex CLI:

   codex plugin marketplace add tsedio/tsed --sparse .agents/plugins --sparse plugins

2. Restart the ChatGPT desktop app.

3. Open the Plugins Directory, choose the Ts.ED marketplace, then install the Ts.ED plugin.

4. Start a new chat: the skills and the MCP tools of the plugin are only loaded in new sessions.

TIP

No Codex CLI? Declare the marketplace yourself in ~/.agents/plugins/marketplace.json (personal) or .agents/plugins/marketplace.json (repository), then restart the app. See Build plugins in the Codex documentation.

GitHub Copilot (VS Code)

GitHub Copilot in VS Code supports agent plugins and reads the Claude plugin format, so it installs the same plugin, with its skills and its MCP server.

1. Add the Ts.ED marketplace to your VS Code settings:

   {
     "chat.plugins.marketplaces": ["tsedio/tsed"]
   }

2. Open the Extensions view and enter @agentPlugins in the search field.

3. Select Install on the Ts.ED plugin and confirm the trust prompt shown for a new marketplace.

TIP

Agent plugins are controlled by the chat.plugins.enabled setting.

Skills.sh (any agent)

The skills CLI copies the skills into the directory your agent reads (.agents/skills, .claude/skills, .cursor/skills, ...). Always target the plugin directory so only the application skills are installed:

# pick skills and agents interactively
npx skills add tsedio/tsed/plugins/tsed

# list the available skills
npx skills add tsedio/tsed/plugins/tsed --list

# install everything for specific agents, without prompts
npx skills add tsedio/tsed/plugins/tsed --skill '*' -a claude-code -a codex -y

Add -g to install the skills globally instead of in the current project.

WARNING

skills.sh installs skills only. Configure the MCP server yourself with the snippet below.

The table below gives the agent name to pass to -a and the file where the MCP server is declared:

Agent	Skills	MCP configuration
Cursor	npx skills add tsedio/tsed/plugins/tsed -a cursor	.cursor/mcp.json or ~/.cursor/mcp.json
Gemini CLI	npx skills add tsedio/tsed/plugins/tsed -a gemini-cli	.gemini/settings.json or ~/.gemini/settings.json

See the skills.sh documentation for the other supported agents.

Ts.ED CLI MCP server

The plugin registers the MCP server bundled with @tsed/cli. If you installed the skills with skills.sh, or use another MCP client, declare it manually. It requires Node.js 22 or newer.

.mcp.json (Claude Code, VS Code)

{
  "mcpServers": {
    "tsed": {
      "command": "npx",
      "args": ["-y", "-p", "@tsed/cli", "tsed", "mcp"]
    }
  }
}

.cursor/mcp.json

{
  "mcpServers": {
    "tsed": {
      "command": "npx",
      "args": ["-y", "-p", "@tsed/cli", "tsed", "mcp"]
    }
  }
}

.gemini/settings.json

{
  "mcpServers": {
    "tsed": {
      "command": "npx",
      "args": ["-y", "-p", "@tsed/cli", "tsed", "mcp"]
    }
  }
}

~/.codex/config.toml

[mcp_servers.tsed]
command = "npx"
args = ["-y", "-p", "@tsed/cli", "tsed", "mcp"]

Claude Code CLI

claude mcp add tsed -- npx -y -p @tsed/cli tsed mcp

WARNING

Use npx -y -p @tsed/cli tsed mcp. The shorter npx -y @tsed/cli mcp fails when the CLI is not installed yet, because the package name is not the binary name.

The server exposes the following capabilities:

Kind	Name	Purpose
Tool	set-workspace	Select the project directory used by the other tools.
Tool	init-project	Scaffold a new Ts.ED project (same options as tsed init).
Tool	list-templates	List the generator templates, including your custom templates.
Tool	get-template	Describe a template and its JSON schema.
Tool	generate-file	Generate a file from a template (same as tsed generate).
Resource	tsed://init/options	Options accepted by init-project.
Resource	tsed://project/info	Current project, its package.json and Ts.ED preferences.
Resource	tsed://server/info	CLI and MCP server versions.

Available skills

Skill	Use it to
tsed-docs	Find the right documentation page through llms.txt and the markdown twin of each page.
tsed-cli	Scaffold projects and generate files with the CLI or its MCP server.
tsed-configuration	Configure the server, the platform adapter and the configuration sources.
tsed-di	Write providers, use the functional DI API, scopes, hooks and the request context.
tsed-controllers	Write controllers, routes, parameters and responses.
tsed-models	Declare models, validate inputs and serialize outputs.
tsed-middlewares	Add middlewares, interceptors, pipes and authentication guards.
tsed-exceptions	Throw HTTP exceptions, write exception filters and response filters.
tsed-testing	Write unit and integration tests with Vitest and PlatformTest.
tsed-openapi	Document the API with Swagger or Scalar.
tsed-logger	Configure @tsed/logger, appenders, layouts and request logging.
tsed-mcp-server	Expose MCP tools, resources and prompts from your application.
tsed-migration	Migrate an application to Ts.ED v8.

Documentation for agents

The skills link to the documentation instead of duplicating it. Each documentation site exposes an llms.txt index, and every page is available as markdown by appending .md to its URL (for example https://tsed.dev/docs/controllers.md).

Site	Index
Framework	https://tsed.dev/llms.txt
CLI	https://cli.tsed.dev/llms.txt
Logger	https://logger.tsed.dev/llms.txt

Update

# Claude Code
claude plugin marketplace update tsed

# Codex
codex plugin marketplace upgrade tsed

# skills.sh
npx skills update

Feedback

The skills are maintained with the framework. Open an issue or a pull request on GitHub when a skill produces outdated or incorrect code.