sync-skill-from-gdrive

Pull skills from a Google Drive folder and install them locally as a Claude Code plugin called g-drive-skills. This skill bridges Drive (the team's shared storage) and the user's local Claude installation. Follow these steps exactly.

Step 1 — Resolve the source folder name

Read ~/.claude/idyllo-skills-sync.json. It may contain { "folderName": "...", "lastSyncAt": "..." }.

• If folderName is set, use it as the Drive source folder name.
• If the file does not exist or folderName is empty/missing, ask the user: "Which Google Drive folder contains the team skills?" Then store the answer by writing (or updating) ~/.claude/idyllo-skills-sync.json with { "folderName": "<answer>" } before continuing.

Step 2 — Authenticate with Google Drive

Attempt the Drive operation in Step 3 first. Only run the authentication flow if you get an auth/permission error:

1. Call mcp__claude_ai_Google_Drive__authenticate
2. Tell the user: "Please complete Google Drive authentication in your browser."
3. After they confirm, call mcp__claude_ai_Google_Drive__complete_authentication
4. Retry Step 3.

Step 3 — Find the skills folder and list its contents

Use the Google Drive MCP to search for a folder whose name matches folderName. Then list all direct children of that folder.

Step 4 — Assemble the local plugin directory

The plugin staging directory is ~/.claude/g-drive-skills/.

4a. Write the plugin manifest at ~/.claude/g-drive-skills/.claude-plugin/plugin.json.

Use the current UTC timestamp (seconds since epoch) as the patch version so the plugin is always recognised as updated on reinstall:

{
  "name": "g-drive-skills",
  "version": "1.0.<unix-timestamp>",
  "description": "Team skills synced from Google Drive"
}

Get the timestamp via Bash: date +%s

4b. Write each skill from the Drive folder. Identify skills by this rule:

• Folder containing a SKILL.md → skill name is the folder name; fetch SKILL.md (and any other files in the folder).
• Standalone .md file with YAML frontmatter containing a name: field → skill name is the name value from frontmatter.

For each skill:

1. Write to ~/.claude/g-drive-skills/skills/<skill-name>/SKILL.md. Drive is the source of truth — overwrite any existing file.
2. Mirror any additional files (e.g. a references/ subdirectory) under ~/.claude/g-drive-skills/skills/<skill-name>/.
3. Track whether the file was newly created or its content changed.

Step 5 — Install (or reinstall) the plugin

Run this command via Bash:

claude plugin install --force ~/.claude/g-drive-skills

The --force flag reinstalls cleanly when the plugin is already present. If --force is not a valid flag, run claude plugin uninstall g-drive-skills first (ignoring errors if it wasn't installed), then claude plugin install ~/.claude/g-drive-skills.

Step 6 — Update the sync marker

Write (or update) ~/.claude/idyllo-skills-sync.json:

{
  "folderName": "<resolved folder name>",
  "lastSyncAt": "<ISO 8601 timestamp of now>"
}

Step 7 — Report results

• If skills were added or changed: print a concise one-line summary, e.g. "Synced 3 skills from Drive into the g-drive-skills plugin (2 updated, 1 new)."
• If nothing changed: print nothing.
• If there was an error: report it clearly and stop.