@lavendly/skills

Bundled Lavendly agent skills - markdown operating manuals that teach an agent how to use the @lavendly/mcp tools well.

What's a skill?

A short markdown file with a YAML frontmatter header. The MCP server tells an agent what tools exist; the skill tells it when and how to use them.

This package ships three first-party skills:

| Skill | Trigger | Priority | |---|---|---| | storyteller | Narrated short-form video from a one-line idea | normal | | multi-clip | Coherent multi-shot sequences with shared anchors | normal | | cost-aware | Budget guardrails for autonomous loops | high |

cost-aware is high-priority - load it alongside any domain skill and its budget rules override the domain choices when they conflict.

Install for Claude Code

npx -y @lavendly/skills install                # all three
npx -y @lavendly/skills install storyteller    # one at a time

Files land in ~/.claude/skills/lavendly-<name>.md. Restart Claude Code.

Programmatic use

import { loadSkill, loadMany, listSkills } from '@lavendly/skills';

console.log(listSkills());                // ['cost-aware', 'multi-clip', 'storyteller']

const systemPrompt = baseSystem + '\n\n' + loadSkill('storyteller');

// Layer skills - order is precedence:
const layered = baseSystem + '\n\n' + loadMany(['cost-aware', 'storyteller']);

CLI

npx -y @lavendly/skills list
npx -y @lavendly/skills show storyteller     # prints markdown to stdout
npx -y @lavendly/skills install              # installs all into ~/.claude/skills/

Author your own

A skill is plain markdown. See https://docs.lavendly.ai/agent-skills/authoring for the anatomy and copy-paste templates.

License

MIT