agentdev-workflow-third-party-sync

Synchronizes third-party skills declared in skills.yaml via a dedicated fetch tool.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-workflow-third-party-sync-yogata
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentdev-workflow-third-party-sync
Source: https://github.com/yogata/agent-dev-flow/tree/main/src/opencode/skills/agentdev-workflow-third-party-sync
Command: npx skills add https://github.com/yogata/agent-dev-flow --skill agentdev-workflow-third-party-sync-yogata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing externally sourced skills alongside repository-managed ones risks accidental overwrites and inconsistent installs. This Skill provides the workflow body for the third-party-sync command, reading the skills.yaml declaration file, validating it, pre-checking for unmanaged placement conflicts, and delegating the actual fetch to a dedicated Custom Tool so third-party skills are installed safely and reproducibly. ## Core Features & Use Cases - Declaration validation: Parses skills.yaml and enforces schema rules such as kebab-case names, required source URLs, and rejection of reserved prefixes (agentdev-, repo-) and disallowed fields. - Conflict pre-detection: Before fetching, detects collisions with unmanaged existing placements under .opencode/skills/ and stops instead of overwriting them. - Delegated fetch with dry-run: Delegates acquisition to the third-party skill fetch Custom Tool, supporting dry-run mode that shows the plan (targets, placement paths, source formats) without making changes. - Use Case: A team declares community-built skills in skills.yaml. Running /agentdev/third-party-sync installs or updates all declared skills into .opencode/skills/ while protecting any manually placed skills from being overwritten. ## Quick Start Run the /agentdev/third-party-sync command, optionally naming a single declared skill or adding dry-run, to fetch and place the declared third-party skills.

Frequently Asked Questions about agentdev-workflow-third-party-sync

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

FAQPage Schema
How do I install third-party skills declared in skills.yaml?▼

Run the /agentdev/third-party-sync command. It reads skills.yaml, validates each declaration, checks for placement conflicts, and delegates the fetch to a dedicated Custom Tool that places skills under .opencode/skills/.

How do I preview third-party skill sync without making changes?▼

Pass the dry-run option to the third-party-sync command. It shows the plan only, including target list, placement paths, source URL formats, and conflict pre-check results, without fetching or placing anything.

Can I sync only one specific third-party skill instead of all?▼

Yes, pass the skill name to the third-party-sync command and only that declaration is selected. If the name is not declared in skills.yaml, no fetch runs and the skill reports that the name is not declared.

What happens when a third-party skill conflicts with an existing skill directory?▼

The sync pre-detects collisions with unmanaged placements such as repo-*, agentdev-*, or same-named directories not derived from declarations. Conflicting targets are stopped and reported rather than overwritten.

What are the skills.yaml declaration format requirements?▼

Each declaration needs a kebab-case name without agentdev- or repo- prefixes and a source URL. Revision and type fields are rejected; version pinning is expressed through the source URL itself.

What happens when a third-party skill fetch fails partway?▼

Failures are never reported as success. The Custom Tool restores the pre-fetch state, and the skill reports successful and failed targets separately with failure causes.