sync-from-vibe-workflow

Phase 1: Setup & Discovery

1.1 Clone Source Repository

git clone https://github.com/doodledood/claude-code-plugins /tmp/claude-code-plugins

cd /tmp/claude-code-plugins && git pull

1.2 List Skills and Agents

• Skills:

  /tmp/claude-code-plugins/claude-plugins/vibe-workflow/skills/

• Agents:

  /tmp/claude-code-plugins/claude-plugins/vibe-workflow/agents/

./skills/

ls /tmp/claude-code-plugins/claude-plugins/vibe-workflow/skills/
ls /tmp/claude-code-plugins/claude-plugins/vibe-workflow/agents/
ls ./skills/

1. Read each agent file's frontmatter - extract the

   name

   field
2. Search destination skills for matching purpose:
   • Agent

     code-X-reviewer

     → look for

     review-X

     skill
   • Agent

     X-reviewer

     → look for

     review-X

     skill
   • Agent

     X-fixer

     → look for corresponding fix skill (e.g.,

     bugfix

     )
   • Agent names may not match exactly - compare descriptions and purpose
3. For unmatched agents - check if a new skill should be created

1.3 Categorize Skills

• Source

  implement-inplace

  → Destination

  implement

• Source

  review-claude-md-adherence

  → Destination

  review-agents-md-adherence

1.4 Create Todo List

[ ] Clone/update source repository
[ ] List and categorize skills

[ ] Add {skill-name}: copy from source and adapt

[ ] Read {skill-name}: compare source and destination
[ ] Update {skill-name}: apply changes if needed

[ ] Remove {skill-name}: delete from destination

[ ] Update README if skills added/removed
[ ] Commit and push changes

[x] Clone/update source repository
[x] List and categorize skills
[ ] Read bugfix: compare source and destination
[ ] Update bugfix: apply changes if needed
[ ] Read plan: compare source and destination
[ ] Update plan: apply changes if needed
[ ] Add new-skill: copy from source and adapt
[ ] Update README if skills added/removed
[ ] Commit and push changes

Phase 2: Adaptation Rules

2.1 Tool Mappings

TodoWrite

update_plan

Task(subagent)

Skill("vibe-workflow:skill-name")

$skill-name

AskUserQuestion

2.2 File Reference Changes

CLAUDE.md

AGENTS.md

/claude-code-plugins/...

2.3 Special Cases

implement

implement-inplace

implement

review-agents-md-adherence

CLAUDE.md

AGENTS.md

2.4 Skill Format

---
name: skill-name
description: "Description under 500 chars. Include triggers."
---

Skill instructions...

• name

  : max 100 characters

• description

  : max 500 characters

Phase 3: Sync Process

3.1 For Skills to ADD

1. Mark "Add {skill-name}" todo as

   in_progress

2. Copy skill directory from source:
   bash

   cp -r /tmp/claude-code-plugins/claude-plugins/vibe-workflow/skills/<skill-name> ./skills/

3. Read the copied SKILL.md
4. Apply adaptation rules from Phase 2
5. Write adapted skill
6. Mark todo

   completed

3.2 For Skills to MODIFY (Two-Step Process)

1. Mark "Read {skill-name}" todo as

   in_progress

2. Determine the source of truth:
   • Check if source skill is a brief delegation (e.g., "Use the X agent to...")
   • If brief delegation → read the corresponding agent file as the source
   • If full implementation → read the skill file as source
3. Read source (agent or skill based on above)
4. Read destination:

   ./skills/{skill-name}/SKILL.md

5. Identify differences:
   • Content changes in source that should be synced
   • Codex-specific adaptations in destination to preserve
   • Already up-to-date sections (no change needed)
6. Note findings (what needs updating, what's already correct)
7. Mark todo

   completed

1. Mark "Update {skill-name}" todo as

   in_progress

2. If no changes needed → mark

   completed

   , move on
3. If changes needed:
   • Apply source changes while preserving Codex adaptations
   • Use Edit tool for targeted updates (not full rewrites)
   • Ensure the destination skill has the FULL implementation (not a brief delegation)
4. Mark todo

   completed

3.2.1 Agent-to-Skill Sync Pattern

1. Read the source agent file (e.g.,

   agents/code-bugs-reviewer.md

   )
2. Read the destination skill file (e.g.,

   skills/review-bugs/SKILL.md

   )
3. Compare content - the destination should contain:
   • Proper Codex frontmatter (

     name

     ,

     description

     ,

     metadata

     )
   • Full implementation from the agent, adapted for Codex
4. Apply updates from agent to skill:
   • New sections, categories, or guidelines from the agent
   • Updated review processes or criteria
   • New output formats or examples
5. Preserve Codex adaptations:

   • AGENTS.md

     instead of

     CLAUDE.md

   • $skill-name

     invocation format
   • No subagent references
   • Codex frontmatter format

3.3 For Skills to REMOVE

1. Ask user for confirmation before removing
2. If confirmed, delete skill directory
3. Note removal for README update

3.4 Preserve Codex-Specific Content

• AGENTS.md

  references (don't revert to

  CLAUDE.md

  )

• update_plan

  (don't revert to

  TodoWrite

  )

• $skill-name

  invocation format
• Inline execution patterns (don't add subagent references)
• Expanded implementations (destination may have fuller versions than source's brief delegations)

Phase 4: Finalize

4.1 Update README

README.md

• Available Skills section
• Repository Structure (if directories changed)

4.2 Commit Changes

git add <files>
git commit -m "Sync <skill-name> from vibe-workflow"

git add skills/
git commit -m "Sync skills from vibe-workflow"

4.3 Push

git push -u origin <branch>

Edge Cases

Verification Checklist

• All

  Skill("vibe-workflow:...")

  calls converted to

  $skill-name

• All

  TodoWrite

  references converted to

  update_plan

• All

  CLAUDE.md

  references converted to

  AGENTS.md

• No subagent Task() calls remain
• No AskUserQuestion tool references remain
• Description under 500 chars
• Name under 100 chars

Source Reference

• Source repo: https://github.com/doodledood/claude-code-plugins
• Source path:

  claude-plugins/vibe-workflow/skills/

• Note: vibe-workflow is the upstream/source of truth for skill logic