Skip to content

Skills Quickstart

What success looks like

By the end, your skill should be discoverable by loopforge skills list, pass loopforge skills doctor, and run once with a real output.

This tutorial helps beginners create and run a first skill in under 10 minutes.

1. Create Skill Folder

1
mkdir -p .loopforge/skills/hello-skill

2. Add skill.toml

Create .loopforge/skills/hello-skill/skill.toml:

1
2
3
4
name = "hello-skill"
version = "0.1.0"
entry = "SKILL.md"
permissions = ["readonly", "tool:fs_read"]

3. Add SKILL.md

Create .loopforge/skills/hello-skill/SKILL.md:

1
2
3
4
5
6
# hello-skill

Read the repository README and output:
1. Project goal
2. Top 3 commands
3. One likely setup risk

4. Verify Discovery

1
2
3
loopforge skills list --workspace .
loopforge skills show hello-skill --workspace .
loopforge skills doctor --workspace .

5. Run It

1
loopforge skills run hello-skill --workspace . --input "Analyze this repo"

6. Optional: Enable approval policy

Edit ~/.loopforge/config.toml:

1
2
3
4
5
[skills]
allowlist = ["hello-skill"]
require_approval = true
auto_approve_readonly = true
experimental = true

For non-readonly permissions, approve explicitly:

1
export LOOPFORGE_SKILL_APPROVAL_ALLOW=hello-skill

Common Errors

  • skill not found: check folder path and name in skill.toml
  • entry file missing: verify entry points to a real file
  • approval required: set LOOPFORGE_SKILL_APPROVAL_ALLOW or reduce dangerous permissions