Index of every page on this site: llms.txt
All skills
hagaiw avatar

/skillroll-setup

@33ac0e9
Run it yourself

Use when a repository owner needs the shortest safe path from an existing skills folder to a first SkillRoll eval.

  • 4 files
  • 5.3 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/hagaiw/skillroll/skillroll-setup

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈33 tokens for metadata: the name and description. ≈572 when used: this file. ≈747 more on demand in 3 files.

Description uses 1.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈132 characters, or 1.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

SkillRoll setup

SkillRoll drops into an existing skills repository. init creates its small configuration and can add starter Markdown cases; validate checks them without inference; doctor checks the model connection; and eval runs the cases.

First-use path

When the owner has a skills folder but no skillroll.toml or API key, give this path directly. Include both setup modes and the free-route option in the answer, even when recommending the scriptable path:

  1. Install the CLI: uv tool install skillroll.
  2. Create configuration without inference: skillroll init --skills-path <skills-folder> --yes.
  3. Check the repository without inference: skillroll validate --all.
  4. Have the owner create an API key with their provider, configure the endpoint and model, and export the key using the name in api_key_env. Then run skillroll doctor.
  5. After doctor passes, run skillroll eval --all.

init and validate do not need a configuration file or API key before they run. The command above selects the supplied folder. If --skills-path is omitted, --yes accepts the detected skills folder and suppresses questions. An explicit --skills-path still selects the requested folder when used with --yes; --yes does not configure inference. Never put a key in skillroll.toml or claim that setup tested a model before doctor succeeds.

Interactive init asks whether to record any OpenAI-compatible endpoint and defaults to no, leaving inference unset unless endpoint settings are explicitly provided. The separate --openrouter-free option to init selects OpenRouter's changing free route for setup or pipeline sanity checks; init only writes configuration, and this route does not provide skill-quality or release evidence. Use a named model for that evidence.

Instruction-only skill: answer with setup guidance; do not call Skill, Write, or an execution tool. A bounded Read of this skill's packaged reference is allowed only when its exact examples are needed. This skill does not execute the commands or simulate setup. It never performs setup with a Skill action. Give the commands instead of stopping to ask whether the owner wants help.

Read setup context for safe command examples.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 33ac0e9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated 2 weeks ago

README badge

README badge for hagaiw/skillroll/skillroll-setup