> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# Inspect and restore skills

> List published skills, inspect records and version history, and roll back to a prior version.

Use these commands to review published skills, inspect their version history, roll back to a prior version when a release introduces problems, or archive skills that are no longer needed. Start with read-only commands to confirm workspace and skill state before taking any action.

## Before you start

* Confirm the CLI is installed and `atlanai doctor` passes. See [Install atlanai CLI](/tools/cli/how-tos/install).
* Authenticate and confirm `atlanai auth status` shows the expected account.
* Confirm an active workspace context is set by running `atlanai context show`.
* Have at least one published skill in the workspace to inspect. To publish a skill, see [Validate and publish skill](/tools/cli/how-tos/skills).

## List and inspect

* **List skills**: Returns skills in the active workspace. Adjust `--limit` to cap the number of results returned.

  ```bash theme={null}
  atlanai skill list --limit 20
  ```

* **Inspect skill**: Shows the full record for a single skill, including its current status, metadata, and version ordinal.

  ```bash theme={null}
  atlanai skill get skill_123
  ```

## View history

Version history shows every published version in chronological order. Action run history shows governance and security scan results for a skill.

* **View version history**: Lists all published versions of the skill.

  ```bash theme={null}
  atlanai skill versions skill_123
  ```

* **View action runs**: Shows governance and security scan action runs for this skill.

  ```bash theme={null}
  atlanai skill runs skill_123
  ```

## Roll back

Rollback appends a new version that matches the content of a prior version — it does not rewrite history. Always run the dry-run first to confirm the rollback target and the resulting version ordinal before applying it.

* **Preview rollback**: Shows what rollback to a specific version does, including the target version content and the new version number that results.

  ```bash theme={null}
  atlanai skill rollback skill_123 --to 3 --dry-run
  ```

* **Execute rollback**: Applies the rollback. Confirm the skill ID and target version before accepting the prompt.

  ```bash theme={null}
  atlanai skill rollback skill_123 --to 3
  ```

## Approve and archive

`skill approve` unblocks a skill that a review gate has blocked. `skill delete` archives the skill — it removes the skill from default discovery but does not erase its version history. Both commands ask for confirmation before they act.

## Troubleshooting

For errors from `skill list`, `skill rollback`, or approve and archive commands, see [Skill operation errors](/tools/cli/troubleshooting/skill-operation-errors).

## Next steps

* [Manage packages](/tools/cli/how-tos/skills-packages): Install and wire skill dependencies for a repository-managed coding agent.

## See also

* [Validate and publish skill](/tools/cli/how-tos/skills): Push a new skill version to the Registry.
* [Automate workflows](/tools/cli/how-tos/api-automation): Script skill operations non-interactively in CI.
* [Sync skills from GitHub](/registry/skills/how-tos/sync-from-github): Manifest, lockfile, and CI workflow for repository-managed skills.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.