Agent skill

Repomatic Topics

Optimize a repository's GitHub topics. An agent skill from kdeldycke/dotfiles.

BSD-2-ClauseAuto-check: notes

Install Repomatic Topics

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .claude/skills/repomatic-topics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .claude/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .agents/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .agents/skills/repomatic-topics && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .agents/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .cursor/skills/repomatic-topics && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .cursor/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/kdeldycke/dotfiles.git --path dotfiles/.agents/skills/repomatic-topics

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .gemini/skills/repomatic-topics && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .gemini/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .github/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .github/skills/repomatic-topics && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .github/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add kdeldycke/dotfiles --skill repomatic-topics -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install kdeldycke/dotfiles repomatic-topics --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/kdeldycke/dotfiles.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/dotfiles/.agents/skills/repomatic-topics .opencode/skills/repomatic-topics && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "repomatic-topics" agent skill from https://github.com/kdeldycke/dotfiles/tree/main/dotfiles/.agents/skills/repomatic-topics into .opencode/skills/repomatic-topics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "repomatic-topics", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: repomatic-topics
GitHub stars: 173
Token cost: ~843 tokens
SKILL.md length: 395 words
Files: 1
Skills in repo: 25
Repo updated: Oct 4, 2026
First seen: Oct 7, 2026
Licence: BSD-2-Clause

At a glance

Optimize a repository's GitHub topics. An agent skill from kdeldycke/dotfiles.

Works in 5 steps: Inventory features. Read the codebase… → Assess current topics. For each existing… → Classify competitiveness. For each topic → …
SKILL.md covers Context and Instructions
Calls gh; reaches github.com

What it does

Repomatic Topics is an agent skill from kdeldycke/dotfiles. Optimize a repository's GitHub topics. Analyze the competition on each topic page, then pick the topics that make the project easier to find.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code. Recommended model: Sonnet.

It works with GitHub. The repository describes itself as: 🍎 macOS dotfiles for Python developers. The licence is BSD-2-Clause.

Example prompts

“/repomatic-topics”

Requirements

Compatibility (from SKILL.md): Designed for Claude Code. Recommended model: Sonnet.
Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob, WebFetch, WebSearch, Agent, Edit

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Inventory features. Read the codebase (CLI commands, workflows, config options) to understand what the project actually does.
Assess current topics. For each existing topic, fetch https://github.com/topics/{topic} and evaluate
Classify competitiveness. For each topic
Propose candidate topics. Search for niche topics where the repo could rank in the top 3. Look for
Present recommendations. Show a table with

What it can do on your machine

Read from SKILL.md and the folder at commit 7947d0f. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash
- Read
- Grep
- Glob
- WebFetch
- WebSearch
- Agent
- Edit
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- gh
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Claude Code. Recommended model: Sonnet.
From compatibility in the SKILL.md frontmatter.

Context cost

Repomatic Topics loads about 843 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 395 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~40
When it runs · the whole SKILL.md, loaded when a task matches: ~843

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

allowed-tools: Bash, Read, Grep, Glob, WebFetch, WebSearch, Agent, Edit

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kdeldycke/dotfiles at commit 7947d0f, republished under its BSD-2-Clause licence (© kdeldycke). 395 words, ~843 tokens.

Download SKILL.mdSave it as .claude/skills/repomatic-topics/SKILL.md (or your agent's skills folder).

name: repomatic-topics
description: Optimize a repository's GitHub topics. Analyze the competition on each topic page, then pick the topics that make the project easier to find.
allowed-tools: Bash, Read, Grep, Glob, WebFetch, WebSearch, Agent, Edit
compatibility: Designed for Claude Code. Recommended model: Sonnet.
argument-hint: [audit|apply]

Context

!grep -A1 '^\[project\]' pyproject.toml 2>/dev/null | tail -1 !gh api repos/{owner}/{repo} --jq '.topics | join(", ")' 2>/dev/null || echo "NO_GH_ACCESS"

Instructions

You help users optimize their GitHub repository topics (tags) for maximum discoverability, balancing accuracy with competitive positioning on GitHub topic pages.

Determine repository

Read pyproject.toml for the project name, description, and keywords list.
Use gh api to fetch the current GitHub topics from the repo.

Argument handling

audit (default when $ARGUMENTS is empty): Analyze current topics and recommend changes. Do not apply.
apply: Analyze, confirm with the user, then apply via gh api --method PUT repos/{owner}/{repo}/topics.

Analysis process

Inventory features. Read the codebase (CLI commands, workflows, config options) to understand what the project actually does.
Assess current topics. For each existing topic, fetch https://github.com/topics/{topic} and evaluate:
- How many repos use the topic.
- What star count is needed to appear on page 1 (above the fold).
- Whether this repo can realistically rank there.
Classify competitiveness. For each topic:
- High competition (page 1 requires 10k+ stars): effectively invisible. Drop unless the topic is core identity.
- Medium (page 1 requires 1k-10k stars): keep only if the repo is borderline viable.
- Low/niche (page 1 requires <1k stars or few total repos): high ROI — keep or add.
Propose candidate topics. Search for niche topics where the repo could rank in the top 3. Look for:
- Feature-specific topics (e.g., github-labels, reusable-workflows) over generic ones (e.g., labels, ci-cd).
- Compound topics that narrow the audience (e.g., python-automation vs automation).
- Topics with few repos where claiming them gives instant #1 ranking.
Present recommendations. Show a table with:
- Topics to keep (with rank assessment).
- Topics to drop (with reason: too competitive, inaccurate, etc.).
- Topics to add (with repo count and expected rank).

Show full SKILL.md (110 more words)Show less

GitHub allows up to 20 topics. Fill all 20 slots — unused slots are wasted discoverability.

Required topics for awesome lists

If the repository name starts with awesome-, it must have both the awesome and awesome-list topics. This is enforced by awesome-lint. Flag any missing required topic during audit, and add them during apply.

After analysis

Confirm changes with the user before applying.
When applying, update both GitHub topics (gh api --method PUT repos/{owner}/{repo}/topics) and pyproject.toml keywords to stay in sync.
The pyproject.toml keywords serve PyPI search — keep them aligned with GitHub topics.

Next steps

Push the change: lint.yaml validates the updated pyproject.toml, and the new GitHub topics take effect immediately.

Files

Just SKILL.md in dotfiles/.agents/skills/repomatic-topics of kdeldycke/dotfiles.

Open the folder on GitHubat commit 7947d0f

Compare with similar skills

Repomatic Topics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Repomatic Topics compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Repomatic Topics this skillkdeldycke/dotfiles	173	—	~843	Automated safety check: Notes	BSD-2-Clause	4 days ago
PR Babysitteropeninterpreter/openinterpreter	69k	3 repos	~4.2k	Automated safety check: Pass	Apache-2.0	2 days ago
Diagnosing Superpowers Sessionsobra/superpowers	296k	3 repos	~1.7k	Automated safety check: Pass	MIT	yesterday
GitHub Deep Researchbytedance/deer-flow	83k	5 repos	~1.3k	Automated safety check: Pass	MIT	yesterday
Greplooponyx-dot-app/onyx	32k	4 repos	~3.3k	Automated safety check: Pass	MIT	yesterday
Update V8 Versionopeninterpreter/openinterpreter	69k	2 repos	~845	Automated safety check: Pass	Apache-2.0	2 days ago

Similar skills

PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
69k GitHub starsUsed in 3 repos~4.2k tokens
DevelopmentAuto-check passed
Diagnosing Superpowers Sessions
obra/superpowers
Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.
296k GitHub starsUsed in 3 repos~1.7k tokens
Agent WorkflowsAuto-check passed
GitHub Deep Research
bytedance/deer-flow
Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.
83k GitHub starsUsed in 5 repos~1.3k tokens
Research & ScienceAuto-check passed
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
32k GitHub starsUsed in 4 repos~3.3k tokens
DevelopmentAuto-check passed
Update V8 Version
openinterpreter/openinterpreter
Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.
69k GitHub starsUsed in 2 repos~845 tokens
DevOps & CloudAuto-check passed
Last30days
mvanhorn/last30days-skill
Research what people actually say about any topic in the last 30 days.
64k GitHub stars~7.8k tokensUpdated yesterday
Research & ScienceAuto-check: notes

More from kdeldycke/dotfiles

All 25 skills in this repo

Agent Config Self Tune
kdeldycke/dotfiles
Audit and tune the configuration of coding agents across Claude Code and pi - settings files (settings.json, settings.local.json), permission rules, instruction files (CLAUDE.md, AGENTS.md), skill…
173 GitHub stars~3.4k tokensUpdated 4 days ago
Auto-check: notes
Audit Repo Issues
kdeldycke/dotfiles
Analyze a GitHub repository's issues and PRs to find unaddressed feature requests, dismissed ideas, maintenance signals, and opportunities relevant to the current project.
173 GitHub stars~2.5k tokensUpdated 4 days ago
Auto-check passed
Brand Assets
kdeldycke/dotfiles
Create project logo and banner SVGs, then export them to light and dark PNG variants.
173 GitHub stars~4.7k tokensUpdated 4 days ago
Auto-check passed
Fill Web Form
kdeldycke/dotfiles
Fill a web form using data extracted from local documents (PDFs, images, spreadsheets).
173 GitHub stars~2.3k tokensUpdated 4 days ago
Auto-check passed
Rename With Dates
kdeldycke/dotfiles
Rename documents and files (PDFs, images, screenshots, etc.) by reading their content to extract the effective/publication date, then renaming them with a "YYYY-MM-DD - Clear descriptive title.ext"…
173 GitHub stars~3.5k tokensUpdated 4 days ago
Auto-check passed
Repomatic Test Matrix
kdeldycke/dotfiles
Choose what a repository's CI test matrix covers. An agent skill from kdeldycke/dotfiles.
173 GitHub stars~2.2k tokensUpdated 4 days ago
Auto-check: notes

Works with

GitHub

Questions about Repomatic Topics

What does Repomatic Topics do?

Optimize a repository's GitHub topics. An agent skill from kdeldycke/dotfiles. Repomatic Topics is an agent skill from kdeldycke/dotfiles. Optimize a repository's GitHub topics.

How do I install Repomatic Topics in Claude Code?

Run `npx skills add kdeldycke/dotfiles --skill repomatic-topics -a claude-code`. Or copy the skill folder (dotfiles/.agents/skills/repomatic-topics in kdeldycke/dotfiles) into .claude/skills/repomatic-topics in your project. Claude Code loads it when a task matches its description.

How do I install Repomatic Topics in Codex?

Run `npx skills add kdeldycke/dotfiles --skill repomatic-topics -a codex`. Or copy the skill folder (dotfiles/.agents/skills/repomatic-topics in kdeldycke/dotfiles) into .agents/skills/repomatic-topics in your project. Codex loads it when a task matches its description.

Can I use Repomatic Topics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kdeldycke/dotfiles --skill repomatic-topics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repomatic-topics, .gemini/skills/repomatic-topics, .github/skills/repomatic-topics and .opencode/skills/repomatic-topics in your project.

What does Repomatic Topics need to run?

Going by SKILL.md and its folder, Repomatic Topics needs the command-line tools its instructions call (gh). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob, WebFetch, WebSearch, Agent, Edit. Compatibility (from SKILL.md): Designed for Claude Code. Recommended model: Sonnet..

Does Repomatic Topics access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Repomatic Topics safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Repomatic Topics use?

Repomatic Topics is published under the BSD-2-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Repomatic Topics use?

About 843 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Repomatic Topics?

Skills that share tags, products or a category with Repomatic Topics: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Diagnosing Superpowers Sessions (obra/superpowers, 296k stars), GitHub Deep Research (bytedance/deer-flow, 83k stars) and Greploop (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repomatic Topics?

kdeldycke (a GitHub user) maintains it in kdeldycke/dotfiles, which has 173 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 4, 2026.

Source: kdeldycke/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Repomatic Topics

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Context

Instructions

Determine repository

Argument handling

Analysis process

Required topics for awesome lists

After analysis

Next steps

Files

Compare with similar skills

Similar skills

More from kdeldycke/dotfiles

Related

Questions about Repomatic Topics