Agent Skills

Agent Skills are portable instructions that help AI agents discover how to work with a tool or project.

lets ships one bundled skill named lets. It explains how agents should inspect lets.yaml, discover available commands, prefer project-defined tasks, and safely modify lets configuration.

The feature is experimental and might change or be removed in a future release.

What gets installed

The lets skill is installed as a standard Agent Skills directory:

.agents/skills/lets/SKILL.md

For global installs, the same directory is created under your home directory:

~/.agents/skills/lets/SKILL.md

Any compatible agent can discover the skill from those locations.

Show the bundled skill

Print the bundled skill to stdout:

lets self skills show

Use this to inspect exactly what will be installed.

Install the skill

Run the install command:

lets self skills install

Without flags, lets prompts you to choose local or global scope and shows the exact install path for each option.

Install for the current project:

lets self skills install --local

This writes to .agents/skills/lets/ at the current Git repository root.

Install for the current user:

lets self skills install --global

This writes to ~/.agents/skills/lets/.

Install to a custom skills directory:

lets self skills install --path /path/to/.agents/skills

Overwrite an existing installed skill:

lets self skills install --force

The optional skill name is accepted for compatibility:

lets self skills install lets

lets currently ships only the lets skill.

Update the skill

Update installed copies to the version bundled in the current lets binary:

lets self skills update

You can also pass the skill name:

lets self skills update lets

Update checks the known local and global locations:

• .agents/skills/lets/ at the current Git repository root
• ~/.agents/skills/lets/

Skills installed with --path are not discovered by update; reinstall with --path --force to refresh a custom location.

Remove the skill

There is no dedicated remove command. Delete the installed skill directory.

Remove the local project skill:

rm -rf .agents/skills/lets

Remove the global user skill:

rm -rf ~/.agents/skills/lets

After removal, compatible agents will stop discovering the bundled lets skill from that location.