Skip to content

feat: add bundled Automating Your Work skill - #3797

Open
just-cameron wants to merge 13 commits into
mainfrom
letta/building-routines-skill-d43eec40
Open

feat: add bundled Automating Your Work skill#3797
just-cameron wants to merge 13 commits into
mainfrom
letta/building-routines-skill-d43eec40

Conversation

@just-cameron

@just-cameron just-cameron commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Overlord (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Summary

Adds a bundled Building Automation skill. It helps an agent extend itself with one-off and recurring workflows built on the Letta Agent SDK.

What the skill explains

  • Call the agent itself in a new or saved conversation so the automation can reuse its memory and identity.
  • Select a lower-cost model for a non-default automation conversation without changing the agent model used by other conversations.
  • Build one-off helpers, reusable commands, scheduled programs, event-driven programs, and longer-running services.
  • Combine instructions for judgment, code for fixed work, and agent turns for interpretation and tool use.
  • Use temporary worker agents, persistent specialist agents, or additional conversations when separate context, another model, parallel work, or independent review helps.
  • Run tools in managed cloud sandboxes, on connected computers in the Letta organization, on the current machine, or through a remote App Server. Connected computers can also form fleets of CI machines, infrastructure nodes, or test machines.
  • Choose options for state, tools, permissions, structured results, reporting, and operations.

Examples

references/sdk-recipes.md includes TypeScript examples for:

  • Calling an existing agent for a one-off task.
  • Creating or resuming a conversation with its own model selection.
  • Creating a hidden temporary worker with its own model and read-only toolset.
  • Running workers in parallel.
  • Saving conversations by resource.
  • Scheduling work and handling events.
  • Reporting a worker result to a coordinator conversation.
  • Discovering online organization computers and selecting one by stable deviceId.

The worker patterns draw from Sarah’s dynamic workflow examples in letta-agent-sdk#261, including parallel audits, fix loops, planning panels, verified research, and isolated sandbox migrations.

Battle testing

Fresh agents applied the skill to three different requests:

  • A deterministic Markdown-to-JSON transformation stayed as ordinary TypeScript and did not use the Agent SDK.
  • Repeated GitHub triage used the same agent in a lower-cost non-default conversation and did not add worker agents.
  • A 40-file migration used temporary workers, separate cloud sandboxes, bounded concurrency, and a second review stage.
  • A live SDK 0.6.3 smoke created a hidden agent, selected Haiku on a non-default conversation, cloned letta-ai/letta-agent-sdk into a managed cloud sandbox, used the restricted Read tool, returned the package name, and deleted the temporary agent. The conversation record showed anthropic/claude-haiku-4-5.
  • A live client.computers.list({ onlineOnly: true }) call returned online computers with the documented stable selectors.

The first migration test found two gaps: the worker recipe passed a local cwd to a cloud session and used unbounded Promise.all. The recipe now shows repository seeding into /root/workspace, terminateOnClose, bounded concurrency, tool restrictions, and review staging. A fresh agent retested the revised examples and found no material defects.

Validation

  • bun run check — all 12 checks pass.
  • Agent SDK examples compile against the published @letta-ai/letta-agent-sdk@0.6.3 types.
  • bun run build packages skills/building-automation/ with the same files as the source directory.

just-cameron and others added 2 commits August 11, 2026 15:56
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Adds a bundled skill that teaches agents to turn repeated or observed
work into the smallest executable form that can own it: practice, skill
with scripts, one-shot workflow, scheduled routine, watcher, or an
event-driven service built with the Letta Agent SDK.

SKILL.md carries the decision layer: build/no-build triggers, the
judgment-vs-mechanics partition, a six-rung ladder with
promotion-on-evidence and deliberate retirement, five explicit design
decisions, and a pre-build gate. references/sdk-recipes.md holds
runnable Agent SDK patterns (cloud-sandbox-first client setup, one-shot
turns, conversation-per-resource with external state, watcher loops,
coordinator reporting, failure handling) verified against the published
0.6.3 typings. references/operations.md holds the operational
invariants: event envelopes, cursors and reconciliation, idempotency
and provider readback, budgets, recursion controls, manifests, and
retirement.

Synthesized from RFC responses by deployed agents (Ezra, Co, Mike,
Grumble) collected in /Users/cameron/Documents/agent-sdk-request-for-commentary.md.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Use Cameron’s specified name for the bundled skill instead of allowing the RFC feedback to override it.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
@just-cameron just-cameron changed the title feat: add bundled building-routines skill feat: add bundled Building Automation skill Aug 11, 2026
@just-cameron
just-cameron deleted the letta/building-routines-skill-d43eec40 branch August 11, 2026 23:01
@just-cameron
just-cameron restored the letta/building-routines-skill-d43eec40 branch August 11, 2026 23:01
@just-cameron just-cameron reopened this Aug 11, 2026
just-cameron and others added 3 commits August 11, 2026 16:09
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Describe the skill directly as guidance for using the Agent SDK to build one-off or repeated automations.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Replace the staged decision gates and mandates with plain descriptions of available automation forms, Agent SDK capabilities, state and execution choices, and optional operational features.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Explain how an agent can call itself through the Agent SDK, continue work in separate conversations, and use temporary or persistent worker agents when another context, model, or parallel task helps. Add a typed temporary-worker example based on Sarah’s dynamic workflow patterns.

Co-authored-by: Cameron <cameron@letta.com>
Co-authored-by: Sarah Wooders <sarah@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Comment thread src/skills/builtin/automating-your-work/SKILL.md
just-cameron and others added 3 commits August 11, 2026 16:34
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Show how an automation can use a lower-cost model in a non-default conversation while retaining the agent’s memory and identity. Clarify that a model update on the default conversation applies to the agent.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Fix the cloud worker example so local paths are not passed into managed sandboxes. Show repository seeding, current computer selectors, bounded concurrency, tool restrictions, review stages, and sandbox cleanup using the published Agent SDK surface.

Co-authored-by: Cameron <cameron@letta.com>
Co-authored-by: Sarah Wooders <sarah@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Explain how an automation can run tools in managed cloud sandboxes, on connected organization computers, on the current machine, or through a remote App Server. Add a checked SDK example for discovering online computers and selecting one by stable device ID.

Co-authored-by: Cameron <cameron@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Comment thread src/skills/builtin/automating-your-work/references/sdk-recipes.md
just-cameron and others added 2 commits August 11, 2026 16:58
Letta Code (agent-c2adbf5c-8419-4211-8cd8-3740db164974)

Replace the awkward “repeated automations” phrase with “one-off or recurring workflows.”

Co-authored-by: Cameron <cameron@letta.com>
Co-authored-by: Sarah Wooders <sarah@letta.com>

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Make the skill trigger on automation opportunities and explain how one workflow can coordinate isolated conversations across connected organization machines.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
@just-cameron
just-cameron marked this pull request as ready for review August 12, 2026 00:18
@cursor

cursor Bot commented Aug 12, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

just-cameron and others added 3 commits August 11, 2026 17:42
Separate persisted decisions from delivery receipts and reconcile unknown coordinator sends by stable event marker so retries cannot silently drop effects.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Require evidence of repeated work and an existing-primitive check before introducing Agent SDK machinery, so worked examples do not become default project suggestions.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
Rename the bundled skill around the agent-facing task so it no longer reads as physical building controls.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
@just-cameron just-cameron changed the title feat: add bundled Building Automation skill feat: add bundled Automating Your Work skill Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants