skill-locations

Document Remotion skill placement rules for internal and public directories.

57.9k|4.4k|Updated Jun 23, 2020

Search Tags:#Bun #directory #Skills #Monorepo #ci #symlink #Remotion

One-click install

npx skills add https://github.com/remotion-dev/remotion --skill skill-locations

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: skill-locations
Source: https://github.com/remotion-dev/remotion/tree/main/.agents/skills/skill-locations
Command: npx skills add https://github.com/remotion-dev/remotion --skill skill-locations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers adding or moving Remotion skills often face ambiguity about whether a skill should live as an internal agent-only resource or as a public, redistributable package. This Skill eliminates that confusion by defining the exact directory conventions and synchronization steps.

Core Features & Use Cases

Internal vs Public Placement: Clearly distinguishes between .agents/skills/<skill-name>/SKILL.md for internal skills and packages/skills/skills/<skill-name>/SKILL.md for public skills.
Symlink Management: Requires exposing every public skill to agents via a symlink at .agents/skills/<skill-name>.
Sync and Verification: Specifies running bun run syncskills after adding a public skill, with CI verification through bun run checkskills.
Use Case: When a contributor wants to publish a new Remotion skill, this Skill guides them to place it correctly and run the required synchronization commands.

Quick Start

Use the skill-locations skill to determine where to place a new Remotion skill and run the required sync commands.

Frequently Asked Questions about skill-locations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

Where should I place a new Remotion skill?▼

Place internal agent-only skills in `.agents/skills/<skill-name>/SKILL.md`. Place public, redistributable skills in `packages/skills/skills/<skill-name>/SKILL.md` and expose them via a symlink at `.agents/skills/<skill-name>`.

How do I sync public Remotion skills with agents?▼

After adding a public skill, run `bun run syncskills` to create the required symlink. CI verifies the symlinks using `bun run checkskills` to ensure consistency.

What is the difference between internal and public Remotion skills?▼

Internal skills live in `.agents/skills/` and are agent-only. Public skills live in `packages/skills/skills/` and are redistributable, requiring a symlink in `.agents/skills/` for agent access.

When should I ask whether a skill is internal or public?▼

Ask before moving a skill between `.agents/skills/` and `packages/skills/skills/`. The placement determines whether the skill is redistributable and whether symlink synchronization is required.