fix: update SKILL.md files to use npx tsx with <SKILL_DIR> (#461)

Co-authored-by: Letta <noreply@letta.com>
This commit is contained in:
Charles Packer
2026-01-04 17:52:07 -08:00
committed by GitHub
parent 0914239e89
commit d962356852
3 changed files with 19 additions and 19 deletions

View File

@@ -263,7 +263,7 @@ When creating a new skill from scratch, always run the `init-skill.ts` script. T
Usage:
```bash
npx ts-node scripts/init-skill.ts <skill-name> --path <output-directory>
npx tsx <SKILL_DIR>/scripts/init-skill.ts <skill-name> --path <output-directory>
```
The script:
@@ -335,13 +335,13 @@ Write instructions for using the skill and its bundled resources.
Once development of the skill is complete, it must be packaged into a distributable .skill file that gets shared with the user. The packaging process automatically validates the skill first to ensure it meets all requirements:
```bash
npx ts-node scripts/package-skill.ts <path/to/skill-folder>
npx tsx <SKILL_DIR>/scripts/package-skill.ts <path/to/skill-folder>
```
Optional output directory specification:
```bash
npx ts-node scripts/package-skill.ts <path/to/skill-folder> ./dist
npx tsx <SKILL_DIR>/scripts/package-skill.ts <path/to/skill-folder> ./dist
```
The packaging script will:

View File

@@ -18,7 +18,7 @@ This skill helps you find other agents on the same Letta server.
## Script Usage
```bash
npx ts-node scripts/find-agents.ts [options]
npx tsx <SKILL_DIR>/scripts/find-agents.ts [options]
```
### Options
@@ -39,7 +39,7 @@ npx ts-node scripts/find-agents.ts [options]
Agents created by Letta Code are tagged with `origin:letta-code`. To find only Letta Code agents:
```bash
npx ts-node scripts/find-agents.ts --tags "origin:letta-code"
npx tsx <SKILL_DIR>/scripts/find-agents.ts --tags "origin:letta-code"
```
This is useful when the user is looking for agents they've worked with in Letta Code CLI sessions.
@@ -49,39 +49,39 @@ This is useful when the user is looking for agents they've worked with in Letta
If the user has agents created outside Letta Code (via ADE, SDK, etc.), search without the tag filter:
```bash
npx ts-node scripts/find-agents.ts
npx tsx <SKILL_DIR>/scripts/find-agents.ts
```
## Examples
**List all agents (up to 20):**
```bash
npx ts-node scripts/find-agents.ts
npx tsx <SKILL_DIR>/scripts/find-agents.ts
```
**Find agent by exact name:**
```bash
npx ts-node scripts/find-agents.ts --name "ProjectX-v1"
npx tsx <SKILL_DIR>/scripts/find-agents.ts --name "ProjectX-v1"
```
**Search agents by name (fuzzy):**
```bash
npx ts-node scripts/find-agents.ts --query "project"
npx tsx <SKILL_DIR>/scripts/find-agents.ts --query "project"
```
**Find only Letta Code agents:**
```bash
npx ts-node scripts/find-agents.ts --tags "origin:letta-code"
npx tsx <SKILL_DIR>/scripts/find-agents.ts --tags "origin:letta-code"
```
**Find agents with multiple tags:**
```bash
npx ts-node scripts/find-agents.ts --tags "frontend,production" --match-all-tags
npx tsx <SKILL_DIR>/scripts/find-agents.ts --tags "frontend,production" --match-all-tags
```
**Include memory blocks in results:**
```bash
npx ts-node scripts/find-agents.ts --query "project" --include-blocks
npx tsx <SKILL_DIR>/scripts/find-agents.ts --query "project" --include-blocks
```
## Output

View File

@@ -60,7 +60,7 @@ Example: "What's the ID of the agent you want to migrate memory from?"
Inspect what memory blocks the source agent has:
```bash
npx ts-node scripts/get-agent-blocks.ts --agent-id <source-agent-id>
npx tsx <SKILL_DIR>/scripts/get-agent-blocks.ts --agent-id <source-agent-id>
```
This shows each block's ID, label, description, and value.
@@ -71,14 +71,14 @@ For each block you want to migrate, choose copy or share:
**To Copy (create independent block):**
```bash
npx ts-node scripts/copy-block.ts --block-id <block-id> [--label <new-label>]
npx tsx <SKILL_DIR>/scripts/copy-block.ts --block-id <block-id> [--label <new-label>]
```
Use `--label` if you already have a block with that label (e.g., `--label project-imported`).
**To Share (attach existing block):**
```bash
npx ts-node scripts/attach-block.ts --block-id <block-id>
npx tsx <SKILL_DIR>/scripts/attach-block.ts --block-id <block-id>
```
Add `--read-only` flag to share to make this agent unable to modify the block.
@@ -113,20 +113,20 @@ Scenario: You're a new agent and want to inherit memory from an existing agent "
2. **List its blocks:**
```bash
npx ts-node scripts/get-agent-blocks.ts --agent-id agent-abc123
npx tsx <SKILL_DIR>/scripts/get-agent-blocks.ts --agent-id agent-abc123
# Shows: project (block-def456), human (block-ghi789), persona (block-jkl012)
```
3. **Copy project knowledge to yourself:**
```bash
# If you don't have a 'project' block yet:
npx ts-node scripts/copy-block.ts --block-id block-def456
npx tsx <SKILL_DIR>/scripts/copy-block.ts --block-id block-def456
# If you already have 'project', use --label to rename:
npx ts-node scripts/copy-block.ts --block-id block-def456 --label project-v1
npx tsx <SKILL_DIR>/scripts/copy-block.ts --block-id block-def456 --label project-v1
```
4. **Optionally share human preferences (read-only):**
```bash
npx ts-node scripts/attach-block.ts --block-id block-ghi789 --read-only
npx tsx <SKILL_DIR>/scripts/attach-block.ts --block-id block-ghi789 --read-only
```