feat(agent): add workspace skills support by daryllimyt · Pull Request #2488 · TracecatHQ/tracecat

daryllimyt · 2026-04-06T16:40:50Z

What changed

add workspace-scoped skill models, migration, service layer, and API routes for draft, upload, publish, version, restore, and playground flows
wire published skill versions into agent presets, preset version snapshots, MCP tooling, session config, executor staging, and Claude sandbox/runtime config
regenerate the frontend client and MCP docs for the new backend contract

Why

Workspace skills need a backend lifecycle that is independent from agent presets while still producing reproducible runtime snapshots. This PR establishes that foundation and the runtime plumbing the UI will build on in the next stacked PR.

Impact

workspaces can store, version, publish, and restore skills
presets can bind exact published skill versions and carry them through version snapshots
agent execution and playground sessions can materialize published skills inside the runtime sandbox

Validation

uv run ruff check tracecat/agent/skill tracecat/agent/preset tracecat/agent/session tracecat/agent/executor/activity.py tracecat/agent/runtime/claude_code/runtime.py tracecat/agent/sandbox/config.py tracecat/agent/sandbox/nsjail.py tracecat/agent/service.py tracecat/agent/types.py tracecat/agent/workflow_config.py tracecat/agent/workflow_schemas.py tracecat/api/app.py tracecat/chat/tools.py tracecat/config.py tracecat/db/models.py tracecat/db/tenant_rls.py tracecat/mcp/server.py tracecat/storage/blob.py tests/unit/test_skill_service.py tests/unit/test_agent_preset_service.py tests/unit/test_agent_session_preset_versioning.py tests/unit/test_agent_activities.py tests/unit/test_mcp_server.py tests/unit/test_storage_blob.py alembic/versions/0c6bb8f8e1d1_add_workspace_skills.py
uv run basedpyright tracecat/agent/skill tracecat/agent/preset tracecat/agent/session tracecat/agent/executor/activity.py tracecat/agent/runtime/claude_code/runtime.py tracecat/agent/sandbox/config.py tracecat/agent/sandbox/nsjail.py tracecat/agent/service.py tracecat/agent/types.py tracecat/agent/workflow_config.py tracecat/agent/workflow_schemas.py tracecat/api/app.py tracecat/chat/tools.py tracecat/config.py tracecat/db/models.py tracecat/db/tenant_rls.py tracecat/mcp/server.py tracecat/storage/blob.py tests/unit/test_skill_service.py tests/unit/test_agent_preset_service.py tests/unit/test_agent_session_preset_versioning.py tests/unit/test_agent_activities.py tests/unit/test_mcp_server.py tests/unit/test_storage_blob.py alembic/versions/0c6bb8f8e1d1_add_workspace_skills.py
uv run pytest tests/unit/test_skill_service.py tests/unit/test_agent_preset_service.py tests/unit/test_agent_session_preset_versioning.py tests/unit/test_agent_activities.py tests/unit/test_mcp_server.py tests/unit/test_storage_blob.py

daryllimyt · 2026-04-06T16:41:06Z

feat(ui): build workspace skills studio #2487
feat(agent): add workspace skills support #2488 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

mintlify · 2026-04-06T16:42:04Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tracecat	🟢 Ready	View Preview	Apr 6, 2026, 4:42 PM

zeropath-ai · 2026-04-06T16:45:16Z

✅ No security or compliance issues detected. Reviewed everything up to 6bbdbb3.

Security Overview

🔎 Scanned files: 34 changed file(s)
🔗 Scan Link: https://zeropath.com/app/repositories/00dffd6c-8834-4dc9-b6d8-b44cd1622986?scanId=7e2c15c6-e9db-43c6-939a-67a0c0604236&codeScanTypes=PrScan&tab=issues

Detected Code Changes

The diff is too large to display a summary of code changes.

zeropath-ai · 2026-04-09T18:12:44Z

✅ No security or compliance issues detected. Reviewed everything up to 37e6998.

Security Overview

🔎 Scanned files: 58 changed file(s)
🔗 Scan Link: https://zeropath.com/app/repositories/00dffd6c-8834-4dc9-b6d8-b44cd1622986?scanId=9cf1f3d3-3889-4f94-b599-3ebd82b51e11&codeScanTypes=PrScan&tab=issues

Detected Code Changes

The diff is too large to display a summary of code changes.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 094dfdd6eb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fbe15f8668

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

# Conflicts: # frontend/src/client/schemas.gen.ts # frontend/src/client/types.gen.ts

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1fe9b3ff61

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: abb552c60d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 02b109ce14

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2c01715ed2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 11a2087adc

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 289ce353fb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: be71e3caea

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 16:40 — with GitHub Actions Inactive

daryllimyt mentioned this pull request Apr 6, 2026

feat(ui): build workspace skills studio #2487

Merged

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 16:41 — with GitHub Actions Inactive

daryllimyt changed the title ~~Add workspace skills support for agents~~ feat(agent): add workspace skills support Apr 6, 2026

mintlify Bot deployed to staging - docs April 6, 2026 16:42 View deployment

This comment has been minimized.

Sign in to view

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 16:51 — with GitHub Actions Inactive

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 18:03 — with GitHub Actions Inactive

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 18:04 — with GitHub Actions Inactive

mintlify Bot deployed to staging - docs April 6, 2026 18:04 View deployment

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 18:17 — with GitHub Actions Inactive

daryllimyt temporarily deployed to internal-registry-ci April 6, 2026 18:18 — with GitHub Actions Inactive

This comment has been minimized.

Sign in to view

daryllimyt temporarily deployed to internal-registry-ci April 7, 2026 22:15 — with GitHub Actions Inactive

daryllimyt had a problem deploying to internal-registry-ci April 7, 2026 22:15 — with GitHub Actions Failure

daryllimyt temporarily deployed to internal-registry-ci April 9, 2026 18:07 — with GitHub Actions Inactive

daryllimyt had a problem deploying to internal-registry-ci April 9, 2026 18:07 — with GitHub Actions Failure

daryllimyt temporarily deployed to internal-registry-ci April 9, 2026 18:09 — with GitHub Actions Inactive

daryllimyt had a problem deploying to internal-registry-ci April 9, 2026 18:09 — with GitHub Actions Failure

mintlify Bot deployed to staging - docs April 9, 2026 18:10 View deployment

daryllimyt force-pushed the feat/skills-backend branch from 50bda51 to 6466336 Compare April 9, 2026 20:14

daryllimyt temporarily deployed to internal-registry-ci April 9, 2026 20:14 — with GitHub Actions Inactive

daryllimyt had a problem deploying to internal-registry-ci April 9, 2026 20:14 — with GitHub Actions Failure

mintlify Bot deployed to staging - docs April 9, 2026 20:15 View deployment

daryllimyt temporarily deployed to internal-registry-ci April 9, 2026 20:26 — with GitHub Actions Inactive

daryllimyt added 2 commits April 22, 2026 11:24

fix(ui): block pinned chat preset fallback

059edd5

test: align preset version list assertion

094dfdd

chatgpt-codex-connector Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py Outdated

fix(alembic): linearize workspace skills migration

0a40f3c

This comment has been minimized.

Sign in to view

fix(agent): ensure runtime skills directory exists

fbe15f8

chatgpt-codex-connector Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py Outdated

daryllimyt added 3 commits April 22, 2026 13:33

fix: map preset restore validation errors

442af68

fix: accept crlf skill frontmatter

1937a5a

fix: validate normalized skill content types

52e01cb

This comment has been minimized.

Sign in to view

Merge remote-tracking branch 'origin/main' into feat/skills-backend

1fe9b3f

# Conflicts: # frontend/src/client/schemas.gen.ts # frontend/src/client/types.gen.ts

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py Outdated

fix: accept EOF skill frontmatter delimiter

abb552c

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py

fix: accept BOM skill frontmatter

02b109c

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/preset/service.py

fix: preserve thinking flag in preset reads

1a569a7

This comment has been minimized.

Sign in to view

daryllimyt added 2 commits April 22, 2026 23:29

fix: merge skill metadata before upload validation

bd8026a

fix: bound staged skill upload verification

2c01715

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py Outdated

daryllimyt added 2 commits April 23, 2026 09:38

fix: validate one-shot skill uploads before blob writes

c107fcb

Add agent skill visibility sandbox smoke tests

11a2087

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/api/app.py

fix(fargate): wire skills blob storage bucket

289ce35

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py Outdated

fix: defer draft upload materialization

be71e3c

chatgpt-codex-connector Bot reviewed Apr 23, 2026

View reviewed changes

Comment thread tracecat/agent/skill/service.py

fix: reap expired skill uploads

37e6998

Conversation

daryllimyt commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed

Why

Impact

Validation

Uh oh!

daryllimyt commented Apr 6, 2026

Uh oh!

mintlify Bot commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment has been minimized.

zeropath-ai Bot commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment has been minimized.

zeropath-ai Bot commented Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

This comment has been minimized.

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

This comment has been minimized.

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

This comment has been minimized.

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

daryllimyt commented Apr 6, 2026 •

edited

Loading

mintlify Bot commented Apr 6, 2026 •

edited

Loading

zeropath-ai Bot commented Apr 6, 2026 •

edited

Loading

zeropath-ai Bot commented Apr 9, 2026 •

edited

Loading