Use Remote Skill

Use skills from sources the user supplies or has declared in configuration. Fetch their instructions on demand and apply them to the current task without installing them. Also maintain the catalog in response to configuration requests.

Resolve the request

Distinguish use, inspect, and configure. Inspecting instructions or editing a declaration does not execute the remote skill. A one-time use does not persist a declaration.

Accept natural language, a catalog alias, or <source>[@<skill>] [options]. Extract the source, optional skill selector, optional full-depth discovery, and the user's actual task. Preserve repository URLs, subpaths, and refs; do not invent missing owners or repositories. For example:

• “用 design-review 检查这个页面。” → resolve the configured alias and perform the review.
• “使用 jtsang4/efficient-coding 仓库里的 plan-review。” → source jtsang4/efficient-coding, skill plan-review.
• “这个仓库里的技能放得很深，完整搜索。” → include --full-depth for the supplied source.
• “把这个来源保存为全局的 design-review，网页审查时使用。” → edit global configuration.

For catalog lookup or configuration changes, read references/configuration.md. Read existing declarations from:

• Global: ~/.config/use-remote-skill/config.yaml.
• Project: <project-root>/.agents/remote-skills.yaml.