Agent skill

Repo Maintenance

by IgorWarzocha in IgorWarzocha/Opencode-Workflows

Maintain repository integrity and documentation. An agent skill from IgorWarzocha/Opencode-Workflows.

No licenceAuto-check passed

Install Repo Maintenance

skills CLI
$ npx skills add IgorWarzocha/Opencode-Workflows --skill repo-maintenance -a claude-code

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

GitHub CLI
$ gh skill install IgorWarzocha/Opencode-Workflows repo-maintenance --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/IgorWarzocha/Opencode-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skill/repo-maintenance .claude/skills/repo-maintenance && 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/

Facts

Skill name
repo-maintenance
GitHub stars
122
Token cost
~400 tokens
SKILL.md length
134 words
Files
5 (incl. scripts, references)
Skills in repo
35
Repo updated
First seen
Licence
None found

At a glance

Maintain repository integrity and documentation. An agent skill from IgorWarzocha/Opencode-Workflows.

  • Works in 4 steps: Read affected files - MUST read each… → Analyze issues - Understand what changes… → Ask the user - MUST use question tool to… → …
  • Auditing structure
  • SKILL.md covers Validate Repository, Sync Documentation, After a Failed Audit and Standards
  • Runs Python scripts from its folder; calls python3

What it does

Repo Maintenance is an agent skill from IgorWarzocha/Opencode-Workflows. Maintain repository integrity and documentation. Use for auditing structure, checking config validity, and reviewing inventory. Use proactively to validate the repository or sync documentation. Examples: - user: "Validate the repo" → run auditrepo.py - user: "Check agents" → run auditrepo.py, review errors - user: "Update documentation" → run syncdocs.py - user: "Check for issues" → run full audit

Its SKILL.md is about 400 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/maintenance-standards.md`, `references/validation-rules.md` and `scripts/audit_repo.py`).

The repository describes itself as: An ever evolving repository of Opencode workflow examples that might enhance your experience with it. I only left the stuff that actually works. YMMV.

When your agent uses it

  • Auditing structure
  • Checking config validity
  • Reviewing inventory

Example prompts

  • “Validate the repo”
  • “Check agents”
  • “Update documentation”
  • “/repo-maintenance”

Requirements

  • Python 3

Workflow steps

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

  1. Read affected files - MUST read each file listed in the output
  2. Analyze issues - Understand what changes would fix each issue
  3. Ask the user - MUST use question tool to confirm which fixes to apply
  4. Apply selectively - Only fix what the user approves

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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.

Context cost

Repo Maintenance loads about 400 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 134 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~400
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 134 words (~400 tokens).

“This skill provides the tools to act as a Repo Custodian.”

— opening of SKILL.md by IgorWarzocha
name
repo-maintenance

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, references) in .opencode/skill/repo-maintenance of IgorWarzocha/Opencode-Workflows.

  • SKILL.md
  • references/maintenance-standards.md
  • references/validation-rules.md
  • scripts/audit_repo.py
  • scripts/sync_docs.py

Open the folder on GitHubat commit 6444ec4

Compare with similar skills

Repo Maintenance 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.

Repo Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Maintenance this skillIgorWarzocha/Opencode-Workflows122—~400Automated safety check: PassNone
Audit Integritygithub/awesome-copilot40k—~1kAutomated safety check: PassMIT
Production Auditaffaan-m/ECC277k1 repos~1.9kAutomated safety check: PassMIT
Integration Testingthedaviddias/Front-End-Checklist74k—~514Automated safety check: PassMIT
Open Source Maintainer Assistantslopus/happy24k—~1.9kAutomated safety check: PassMIT
Nemoclaw Maintainer Audit E2E AssertionsNVIDIA/NemoClaw23k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Audit Integrity

    github/awesome-copilot

    Official

    Enforce output quality, evidence verification, and quality gates across security audits.

    40k GitHub stars~1k tokensUpdated 2 days ago
    SecurityAuto-check passed
  • Production Audit

    affaan-m/ECC

    Local-evidence production readiness audit for shipped apps, pre-launch reviews, post-merge checks, and "what breaks in prod?" questions without sending repo data to an external audit service.

    277k GitHub starsUsed in 1 repo~1.9k tokens
    Product & Project ManagementAuto-check passed
  • Integration Testing

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing CI coverage, automated checks, or test strategy related to Write integration tests for key workflows.

    74k GitHub stars~514 tokensUpdated 5 days ago
    Testing & QAAuto-check passed
  • Helps maintain the slopus/happy open source project by triaging issues, drafting closing comments, finding duplicates and checking fixes, with approval before anything is posted.

    24k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Triage, diagnose, debug, or fix failing or flaky NemoClaw E2E tests.

    23k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Audited Boundary Check

    mohitagw15856/pm-claude-skills

    A skill your agent uses when asked to check whether a figure is audited, which headline numbers sit outside the audited accounts, what 'adjusted' or 'underlying' means in this report, or who is…

    1.4k GitHub stars~1.8k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed

More from IgorWarzocha/Opencode-Workflows

All 35 skills in this repo
  • Create Opencode Plugin

    IgorWarzocha/Opencode-Workflows

    Create OpenCode plugins using the @opencode-ai/plugin SDK. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Plugin Installer

    IgorWarzocha/Opencode-Workflows

    Find, install, and configure OpenCode plugins from the catalog or community.

    122 GitHub stars~1.3k tokensUpdated 8 mo ago
    Auto-check passed
  • Skill Creator

    IgorWarzocha/Opencode-Workflows

    Guide for creating effective opencode skills. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~2.8k tokensUpdated 8 mo ago
    Auto-check passed
  • Security AI Keys

    IgorWarzocha/Opencode-Workflows

    Review AI API key leakage patterns and redaction strategies.

    122 GitHub stars~793 tokensUpdated 8 mo ago
    Auto-check: notes
  • Security Convex

    IgorWarzocha/Opencode-Workflows

    Review Convex security audit patterns for authentication and authorization.

    122 GitHub stars~3.1k tokensUpdated 8 mo ago
    Auto-check passed
  • Security Django

    IgorWarzocha/Opencode-Workflows

    Review Django security audit patterns for settings and middleware.

    122 GitHub stars~1.6k tokensUpdated 8 mo ago
    Auto-check: notes

Questions about Repo Maintenance

What does Repo Maintenance do?

Maintain repository integrity and documentation. An agent skill from IgorWarzocha/Opencode-Workflows. Repo Maintenance is an agent skill from IgorWarzocha/Opencode-Workflows. Maintain repository integrity and documentation.

When should I use Repo Maintenance?

Repo Maintenance fits situations like: auditing structure; checking config validity; reviewing inventory.

How do I install Repo Maintenance in Claude Code?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill repo-maintenance -a claude-code`. Or copy the skill folder (.opencode/skill/repo-maintenance in IgorWarzocha/Opencode-Workflows) into .claude/skills/repo-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Repo Maintenance in Codex?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill repo-maintenance -a codex`. Or copy the skill folder (.opencode/skill/repo-maintenance in IgorWarzocha/Opencode-Workflows) into .agents/skills/repo-maintenance in your project. Codex loads it when a task matches its description.

Can I use Repo Maintenance 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 IgorWarzocha/Opencode-Workflows --skill repo-maintenance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repo-maintenance, .gemini/skills/repo-maintenance, .github/skills/repo-maintenance and .opencode/skills/repo-maintenance in your project.

What does Repo Maintenance need to run?

Going by SKILL.md and its folder, Repo Maintenance needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Repo Maintenance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Repo Maintenance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Repo Maintenance use?

No licence was found for Repo Maintenance or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Repo Maintenance use?

About 400 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Repo Maintenance?

Skills that share tags, products or a category with Repo Maintenance: Audit Integrity (github/awesome-copilot, 40k stars), Production Audit (affaan-m/ECC, 277k stars), Integration Testing (thedaviddias/Front-End-Checklist, 74k stars) and Open Source Maintainer Assistant (slopus/happy, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Maintenance?

IgorWarzocha (a GitHub user) maintains it in IgorWarzocha/Opencode-Workflows, which has 122 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on February 4, 2026.

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