Publishes a validated Syncolab skill via GitHub pull request for review and merge to main. Use when submitting a new or updated skill under skills/ to the syncolab-skills repository after local authoring is complete.
Publishes a validated Syncolab skill via GitHub pull request for review and merge to main. Use when submitting a new or updated skill under skills/ to the syncolab-skills repository after local authoring is complete.
Publish Skill
Purpose
Opens a GitHub pull request to add or update a Syncolab skill on main after local authoring and validation are complete. Assumes the syncolab-skills repo is cloned, the agent has shell and GitHub access (git, gh), and skill content already follows repository standards.
For authoring the skill itself, use create-skill first.
When to Use
User asks to publish, submit, PR, or contribute a skill to syncolab-skills.
Skill files exist under skills/<skill-label>/ and should land on main via review.
User finished create-skill work and wants the GitHub workflow next.
When NOT to Use
Skill does not exist or has not been validated → use create-skill first.
User only wants local edits without opening a PR.
User asked to force-push, rewrite history, or merge without review.
Changes are unrelated to skill packages (no skill paths in the PR).
Expected Outcome
Feature branch pushed to origin.
One focused commit (or small logical set) containing the skill changes.
Open PR targeting main with a clear summary and test plan.
PR URL returned to the user.
Skill content meets repository standards (create-skill checklist). Syncolab maintainers update catalog artifacts when merging to main.
Inputs to Gather
Skill label(s) — directory name(s) under skills/, e.g. create-skill.
Remote — origin URL and default branch (usually main).
Git state — branch, uncommitted files, divergence from main.
Review status — skill structure checked against meta.schema.json and instruction files.
User intent — draft PR vs ready for review; any linked issue/ticket.
Confirm the skill package is complete per create-skill before publishing.
If gh is missing or unauthenticated, stop and ask the user to install/auth (gh auth login).
Read create-skill if SKILL.md / meta.yaml are missing or invalid.
2. Review every skill in the change set
Confirm each skill in scope passes the create-skill review checklist (structure, frontmatter, meta.yaml vs schema). Do not open a PR with known schema or naming errors.