菜单
Use this skill to sync plugin SPEC.md files with what's actually on disk (skills, rules, hooks, agents, commands). Recall when the user asks about SPEC.md drift, "are SPEC files up to date", spec scaffolding, or after adding/renaming a skill/rule/hook/command in a plugin.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use this skill to understand the claude marketplaces in the nsheaps github org: the plugin marketplace build, release, and propagation pipeline. Recall this skill when working on CI/CD workflows, mise tasks, plugin versioning, marketplace updates, or when asked how plugins get from source code to a user's Claude Code installation. Also recall when debugging version bumps, marketplace.json drift, or plugin cache issues.
Use this skill when the user asks about GitHub operations, pull requests, issues, releases, actions, gists, repos, or any task involving the GitHub CLI (gh). Also use when needing to interact with GitHub APIs, check CI status, review PRs, manage labels, create releases, or automate GitHub workflows from the command line.
Manually configure the GitHub App bot git identity the way the github-app plugin's SessionStart hook does — resolve the app slug and bot user ID, build the <slug>[bot] name and noreply email, set GIT_AUTHOR_*/GIT_COMMITTER_* env vars, and write an isolated GIT_CONFIG_GLOBAL with the gh auth git-credential helper. Use when commits are attributed to the wrong account, "Author identity unknown" appears, or git identity must be set up by hand. <example>my commits are showing up as the handler, not the bot</example> <example>git says Author identity unknown after the github-app hook ran</example> <example>configure the github app bot git identity manually</example> <example>set up the gh credential helper for git push</example>
Manually reproduce what the github-app plugin's SessionStart hook does to make a GitHub App installation token usable in the current session — materialize the PEM, generate the token, isolate GH_CONFIG_DIR, write the runtime env file, and wire CLAUDE_ENV_FILE so every Bash call sees GH_TOKEN/GITHUB_TOKEN. Use when the hook did not run, the token is missing from the environment, or a shell/teammate needs the token wired up by hand. <example>GH_TOKEN isn't set even though github-app is configured</example> <example>the github-app SessionStart hook didn't run, set up the token manually</example> <example>wire the github app token into CLAUDE_ENV_FILE</example> <example>gh keeps falling back to the wrong account, isolate GH_CONFIG_DIR</example>
Manage GitHub App installation tokens in Claude Code sessions. Use when tokens expire, auth errors occur in long-running sessions, or when setting up GitHub App credentials for agent teams. <example>my github token expired</example> <example>refresh the github app token</example> <example>check token status</example> <example>set up github app authentication for this session</example>
Manages spec files for requirements capture and validation
| name | plugin-spec-sync |
| description | Use this skill to sync plugin SPEC.md files with what's actually on disk (skills, rules, hooks, agents, commands). Recall when the user asks about SPEC.md drift, "are SPEC files up to date", spec scaffolding, or after adding/renaming a skill/rule/hook/command in a plugin. |
Sync plugin SPEC.md files with the filesystem across the entire plugins/ directory.
| Direction | Action |
|---|---|
| FS → SPEC | Item exists in skills/, rules/, commands/, or hooks/hooks.json but missing from SPEC.md → adds stub entry, reusing description from source file |
| SPEC → FS | Item listed in SPEC.md but missing from filesystem → creates stub file/dir, using SPEC description |
| Both exist | No update — descriptions not synced even if they differ |
| Remove | Must be removed from both places manually (never half-removed) |
| SPEC.md missing | Auto-generated from plugin metadata + filesystem scan with TODO: add description placeholders |
Hooks are synced FS → SPEC only (scaffolding hooks.json from SPEC is not supported).
!bin/sync-plugin-specs.sh 2>&1
To sync a single plugin: bin/sync-plugin-specs.sh --plugin <name>
TODO: add description placeholders in newly created or updated SPEC.md entries.No changes needed.