@letta-ai/letta-code 0.14.5 → 0.14.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@letta-ai/letta-code",
3
- "version": "0.14.5",
3
+ "version": "0.14.7",
4
4
  "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -64,10 +64,11 @@ Browse these repositories to discover available skills. Check the README for ski
64
64
 
65
65
  | Location | Path | When to Use |
66
66
  |----------|------|-------------|
67
+ | **Agent-scoped** | `~/.letta/agents/<agent-id>/skills/<skill>/` | Skills for a single agent (default for agent-specific capabilities) |
67
68
  | **Global** | `~/.letta/skills/<skill>/` | General-purpose skills useful across projects |
68
69
  | **Project** | `.skills/<skill>/` | Project-specific skills |
69
70
 
70
- **Rule**: If useful across multiple projects, install globally. If project-specific, install in `.skills/`.
71
+ **Rule**: Default to **agent-scoped** for changes that should apply only to the current agent. Use **project** for repo-specific skills. Use **global** only if all agents should inherit the skill.
71
72
 
72
73
  ## How to Download Skills
73
74
 
@@ -80,10 +81,12 @@ Skills are directories containing SKILL.md and optionally scripts/, references/,
80
81
  git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
81
82
 
82
83
  # 2. Copy the skill to your skills directory
84
+ # For agent-scoped (recommended default):
85
+ cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
83
86
  # For global:
84
- cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/
87
+ # cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/
85
88
  # For project:
86
- cp -r /tmp/skills-temp/skills/webapp-testing .skills/
89
+ # cp -r /tmp/skills-temp/skills/webapp-testing .skills/
87
90
 
88
91
  # 3. Cleanup
89
92
  rm -rf /tmp/skills-temp
@@ -93,7 +96,7 @@ rm -rf /tmp/skills-temp
93
96
 
94
97
  ```bash
95
98
  git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
96
- rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/skills/webapp-testing/
99
+ rsync -av /tmp/skills-temp/skills/webapp-testing/ ~/.letta/agents/<agent-id>/skills/webapp-testing/
97
100
  rm -rf /tmp/skills-temp
98
101
  ```
99
102
 
@@ -106,6 +109,7 @@ Skill(command: "refresh")
106
109
  ```
107
110
 
108
111
  This scans `~/.letta/skills/` and `.skills/` and updates your `skills` memory block.
112
+ Agent-scoped skills under `~/.letta/agents/<agent-id>/skills/` are included in the scan as well.
109
113
 
110
114
  ## Complete Example
111
115
 
@@ -117,7 +121,7 @@ User asks: "Can you help me test my React app's UI?"
117
121
  4. **Download** (trusted source):
118
122
  ```bash
119
123
  git clone --depth 1 https://github.com/anthropics/skills /tmp/skills-temp
120
- cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/skills/
124
+ cp -r /tmp/skills-temp/skills/webapp-testing ~/.letta/agents/<agent-id>/skills/
121
125
  rm -rf /tmp/skills-temp
122
126
  ```
123
127
  5. **Refresh**: `Skill(command: "refresh")`