# Medyll Idae Skiller > Overview - Skill: `tomevault-io/medyll-idae-skiller` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/medyll-idae-skiller` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/medyll-idae-skiller/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/medyll-idae-skiller --- ## Overview `@medyll/skiller` is an npm CLI + library for the full lifecycle of SKILL.md files in @medyll packages: template creation, multi-target installation, multi-model evaluation, HTML reporting, and AI-powered optimization. ## When to use skiller vs other skills | You want to... | Use | |---|---| | Create a SKILL.md template for an @medyll package | **skiller** (`npx @medyll/skiller create-skill`) | | Install a skill to Claude/Cursor/Codex/Windsurf/Zed | **skiller** (`npx @medyll/skiller add-skill`) | | Run multi-model tests on a skill (Claude, Qwen, Ollama) | **skiller** (`npx @medyll/skiller test-skill`) | | View HTML test reports | **skiller** (`npx @medyll/skiller report`) | | AI-optimize a skill based on test failures | **skiller** (`npx @medyll/skiller optimize`) | | Validate/repair SKILL.md frontmatter structure | **skill-master** | | Author a new Claude Code skill from scratch with eval loops | **skill-creator** | ## Install ```bash pnpm add @medyll/skiller ``` ## CLI Commands ### install-skill — Install skiller's own skill (NEW) ```bash npx @medyll/skiller install-skill # Install to user-wide (~/.claude/skills/skiller/) npx @medyll/skiller install-skill --target cursor # Install to specific target ``` Use this to install skiller's documentation to your AI agent. Run from anywhere. ### create-skill — Generate a SKILL.md template ```bash npx @medyll/skiller create-skill --name my-package --description "My package description" ``` Creates `src/lib/skill//SKILL.md` and optionally `test-suite.json`. **SKILL.md lookup order** (used by `add-skill` and all resolution logic): 1. `src/lib/skill//SKILL.md` — source, preferred (@medyll SvelteKit packages) 2. `dist/skill//SKILL.md` — compiled build, fallback when source is absent (consumed as dependency) 3. `lib/skill//SKILL.md` — legacy only ### add-skill — Install a skill to an editor target ```bash npx @medyll/skiller add-skill ``` Interactive prompt to choose a target. Non-interactive: `npx @medyll/skiller add-skill --target user`. **Note:** Run this from within a package directory that has a SKILL.md. ### test-skill — Run multi-model evaluations ```bash npx @medyll/skiller test-skill # All configured models npx @medyll/skiller test-skill --model claude # Specific model npx @medyll/skiller test-skill --parallel # Parallel execution ``` ### report — View HTML test results ```bash npx @medyll/skiller report # Latest report npx @medyll/skiller report --session 20260331-194500 # Specific session ``` ### optimize — AI-powered skill optimization ```bash npx @medyll/skiller optimize --skill my-package npx @medyll/skiller optimize --skill my-package --dry-run # Preview suggestions ``` ## Installation Targets | Target | Location | Scope | |--------|----------|-------| | `user` | `~/.claude/skills//SKILL.md` | Global | | `claude` | `./.claude/skills//SKILL.md` | Project | | `codex` | `~/.codex/skills//SKILL.md` | Global | | `agent` | `./.github/skills//SKILL.md` | Project | | `cursor` | `~/.cursor/skills//SKILL.md` | Global | | `windsurf` | `~/.windsurf/skills//SKILL.md` | Global | | `zed` | `~/.zed/skills//SKILL.md` | Global | | `custom` | User-specified path | Custom | Configuration: `packages/skiller/src/registry.json`. ## test-suite.json Format ```json { "name": "my-skill", "models": [ { "name": "claude", "adapter": "claude" }, { "name": "qwen", "adapter": "qwen", "model": "qwen-turbo" }, { "name": "ollama", "adapter": "ollama", "model": "llama3" } ], "cases": [ { "id": "case-001", "name": "Basic usage test", "input": "User prompt to test against the skill", "assertions": { "min_length": 100, "max_length": 5000, "format": "markdown", "required_keywords": ["import", "function"], "forbidden_keywords": ["deprecated"], "contains_code": true } } ] } ``` **Assertion types:** `min_length`, `max_length`, `format` (markdown|json|code), `required_keywords`, `forbidden_keywords`, `contains_code`. ## SKILL.md Template ```markdown --- name: description: --- ## Overview What the package does, when and why to use it. ## Install \`\`\`bash pnpm add @medyll/ \`\`\` ## Core API Main functions, classes, signatures with brief descriptions. ## Usage Realistic code examples showing typical workflows. ## References Point to references/ files for advanced API docs, integration guides, etc. ``` ## Self-editing workflow (skiller's own SKILL.md) Skiller's authoritative source directory is the **REFERENCE_DIRECTORY** above. All files in this skill (SKILL.md, references/, test-suite.json, etc.) MUST be edited inside that directory. The installed copies (user-wide, project, etc.) are deployment artifacts — never edit them directly. **Rules:** 1. **Directory-first**: Always resolve `REFERENCE_DIRECTORY` before any edit. If the directory does not exist or is unreachable, **do nothing and report** the missing path to the user. Never fall back to editing an installed copy. 2. **After modification**: Once the source SKILL.md has been updated, make it available by: - Stage and **commit** the change (`git add` + `git commit`) - **Push** to remote so CI / other consumers pick it up - Optionally re-run `npx @medyll/skiller install-skill` to refresh the user-wide installed copy ## References For detailed documentation, read these files from `references/`: - **`references/api-reference.md`** — Full library API exports and usage examples - **`references/integration-guide.md`** — How to add `add-skill` to your package, CI/CD setup - **`references/search-paths.md`** — SKILL.md lookup order and usage examples --- > Source: [medyll/idae](https://github.com/medyll/idae) — distributed by [TomeVault](https://tomevault.io).