sync-github-repo-metadata
Sync GitHub Repo Metadata
Use the repository and its configuration as the source of truth. Treat the current README, docs, and existing GitHub metadata as weak hints unless they still match the codebase.
Workflow
- Gather repo facts.
- Read the current remote metadata with:
gh repo view --json nameWithOwner,description,repositoryTopics,homepageUrl,url
- Infer:
- one concise repository description
- a focused topic set based on actual language, framework, domain, and tooling
- Preview the current values, proposed values, and the exact
gh repo editcommand. - Apply changes only after explicit confirmation.
Guidelines
- Do not change homepage or other repo settings unless the user explicitly asks.
- Focus on GitHub description and topics only.
- Prefer a single-sentence description that matches the repo's real purpose.
- Prefer accurate, specific, stable topics over broad buzzwords.
- Prefixing description with an emoji is encouraged.
- Remove stale topics instead of only appending new ones.
- Use lowercase kebab-case topics.
Preview Format
- Current description
- Proposed description
- Current topics
- Proposed topics
- Exact
gh repo editcommand with--description,--add-topic, and--remove-topicarguments as needed
Apply Step
- Never apply blindly.
- After confirmation, run the exact previewed command.
- If authentication or permissions fail, report the command and the failure instead of guessing an alternative.
More from liblaf/skills
write-root-readme
Write or rewrite the repo-root README.md.
36write-python-tests
Write or refresh tests for Python projects. Use when Codex needs to add coverage, replace stale tests, reorganize tests under `tests/`, or lock down Python behavior from source code in repos that use `nox`, `pytest`, and `mise`.
34rewrite-python-docs
Rewrite Python docs and docstrings from source code. Use when Codex needs to refresh the docs.
34write-conventional-commit
Generate exactly one high-quality Conventional Commit message from the current Git diff. Use when Codex needs to inspect staged changes, summarize the dominant intent, and return only the final commit message with no analysis or extra text.
33automate-project-maintenance
Orchestrate repository maintenance. Use when Codex needs one entry point to refresh tests, docs, README, and GitHub metadata.
33