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 three 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 desktop app
skills.sh	Yes	Manual	Cursor, Copilot, Windsurf, Gemini CLI 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.

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

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.

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, Cursor, ...)

{
  "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.