Ben ArentandPaul Gottschling
0f8210cdb7
* First Draft of teleport-session-review skill Framework based on ACL skill * Adds Examples and Playbook for how to use Session Search * Add a preflight check * Feedback from Docs * Extra Testing on a Teleport Cloud Tenant * Docs to Skill * Remove local dev for now * update locate commands to include $TSH * Update docs/pages/identity-security/session-summaries/session-search.mdx Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com> * Remove Filter caveats These have been fixed --------- Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
Teleport Agent Skills
This directory contains Teleport agent skills. Each skill is a self-contained
package that teaches agents such as Claude Code how to perform a specific
Teleport workflow using CLI tools like tctl and tsh.
Installation
These skills follow the Agent Skills specification
and can be installed into any compatible agent (Claude Code, Cursor, Codex,
Gemini CLI, and others) using Vercel's skills
CLI, which discovers and installs skills straight from this repository:
# Session recording review
npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-session-review
# Access list review
npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-acl-review
You'll be prompted to pick which agents to install into and whether to install globally or per-project. Review a skill before use — skills run with your agent's full permissions.
Available Skills
teleport-acl-review
Helps perform bulk reviews of Teleport access lists that are due for periodic audit. Categorizes lists into low-risk that agent can auto-review and those that require human review.
Example invocations:
- Review my Teleport access lists
- Which access lists need review?
- Audit my Teleport ACLs
teleport-session-review
Helps browse, search, and investigate Teleport session recordings. Lists recent
recordings (tctl recordings ls), runs semantic and keyword search over session
summaries (tctl recordings search), presents a risk-triage table, and — with
confirmation — downloads a recording or hands you a playback link.
Install:
npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-session-review
Example invocations:
- Review my recent Teleport session recordings
- Search session recordings for sessions that touched production databases
- What happened in session <id>?
- Find risky or high-severity sessions from last week
- Download the recording for session <id>