Use the Context Hub

Learn how to create, view, and promote context in the LangSmith Context Hub.

The Context Hub gives your team version-controlled, environment-aware management of the instructions and tools your agents use in production. A context is a versioned bundle of agent instructions and tools, either a skill or a full agent, that you manage in LangSmith.

Use this guide to create your first context, view its files and history, and promote it to an environment so your agents can pull it.

1. Open the Context Hub

If you don’t see Context in the left-hand navigation, verify that Context Hub is enabled for your workspace and that you have the required permissions.

In the LangSmith UI, select Context in the left-hand navigation. The Context Hub lists every agent and skill in your workspace.

2. Create a context

1. Click + Create in the top left of the Context Hub.

2. Choose the context type:

   • Agent: a full agent bundle including an AGENTS.md file and tools.
   • Skill: a reusable capability that agents can use, including a SKILL.md file.
   

3. Fill in a name and description. For skills, a description is required. You can also enter the initial file contents (SKILL.md for a skill, AGENTS.md for an agent) now, or add them after creation. Click Create Agent or Create Skill. LangSmith creates the repo and opens it for editing.

3. View a context

Click on an agent or skill from the Context Hub to view it.

The middle panel shows the file tree for the current commit and the right panel previews the selected file. Click a file in the middle panel to open it, then edit it in the right panel and save your changes to create a new commit.

Each saved change creates a new commit in the Commit History panel on the left, so you can browse, compare, and revert prior versions without losing work.

4. Tag and promote a commit

Once a commit is ready to ship, promote it to an environment so downstream agents can pull it.

Context Hub currently supports two environment tags for promotion: staging and production.

1. With the target commit selected, click Promote in the top right.

2. Choose the destination environment:

   • Promote to Production: the commit your production agents pull.
   • Promote to Staging: a pre-production environment for validation.
   

3. The environment label (for example, Production 7ca95573) moves to the promoted commit. Use the Tag button next to Promote to attach a human-readable label to any commit for easy reference.

Agent runtimes that resolve context by environment tag (for example, :production) now pull this promoted commit.

Next steps

• Context engineering concepts: learn about skills, agents, versioning, and sharing.
• Manage contexts with the SDK: push, pull, list, and delete contexts programmatically.

---

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.