◆ Atelier Install

Atelier docs

Agent Skills

Save and restore agent-agnostic Agent Skills with explicit review, encrypted account storage, and safe local installs.

Public commands

The public Agent Skills surface is intentionally small while the workflow is validated.

atl skills scan
atl skills save
atl skills install

What gets scanned

Atelier looks for directories that contain SKILL.md in common global and project skill roots.

~/.agents/skills
~/.pi/agent/skills
~/.claude/skills
~/.cursor/skills
~/.codex/skills
~/.config/opencode/skills

Project roots are scanned when Atelier knows the repository root. Generic folder sync skips any directory containing SKILL.md; use atl skills for those directories so skills get the stricter review and install behavior.

Scan skills

Use scan to see discovered skills, duplicates, provenance, warnings, scripts, and secret findings.

atl skills scan
atl skills scan --json

Save selected skills

atl skills save opens an interactive review picker. No skill is selected by default. Review the list, toggle the skills you want, then save only that selection.

atl skills save

Useful keys:

  • a: review all skills, or select the visible list from a review screen
  • r: review skills with scripts, warnings, or secret findings
  • s: show selected skills
  • / or f: filter
  • space: toggle the highlighted skill
  • n: clear the visible list
  • c or enter: save selected skills
  • q: cancel

For automation, --yes explicitly saves every non-conflicting skill without the picker.

atl skills save --yes

Encrypted account storage

Saved skills are account-scoped, not profile-scoped. Profile config changes by machine context; skills are an account library. Skill files and manifests are encrypted locally with your Atelier vault key before upload.

Install saved skills

Preview first to see canonical installs, detected agent projections, and conflicts.

atl skills install --preview
atl skills install

The canonical install path is:

~/.agents/skills/<skill-name>

When agent-specific roots already exist, Atelier projects the canonical skill into those roots with symlink-first, copy-fallback behavior. Matching existing copies are left untouched.

Conflicts and backups

Atelier never silently overwrites a differing local skill. If the canonical skill or an agent projection differs from the saved version, install blocks until you explicitly allow a backup.

atl skills install --backup

The current local directory is copied into Atelier's local backup area before replacement.

Compatibility

Atelier can scan skills installed by the skills CLI and reads known lock metadata for provenance when available. It does not mutate .skill-lock.json or skills-lock.json.

Safety expectations

Skills are instruction and code surfaces. Save and install flows are explicit by design. Review scripts, warnings, secret findings, provenance, and local conflicts before syncing skills across machines.