Agent skill

Githits Plugin Maintenance

by githits-com in githits-com/githits-cli

Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces.

Apache-2.0Auto-check passedAgent Workflows

Install Githits Plugin Maintenance

skills CLI
$ npx skills add githits-com/githits-cli --skill githits-plugin-maintenance -a claude-code

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

GitHub CLI
$ gh skill install githits-com/githits-cli githits-plugin-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/githits-com/githits-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/githits-plugin-maintenance .claude/skills/githits-plugin-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
githits-plugin-maintenance
GitHub stars
114
Token cost
~1k tokens
SKILL.md length
438 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces.

  • Works in 8 steps: Identify the canonical input that owns… → Read… → Edit canonical inputs only. → …
  • Tasks that involve MCP servers
  • SKILL.md covers Workflow, Canonical Ownership, Transport Contract and Validation, plus 1 more section
  • Calls bun; reaches mcp.githits.com

What it does

Githits Plugin Maintenance is an agent skill from githits-com/githits-cli. Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces. Use only while working in the githits-cli repository when changing skills, agent guidance, plugin or marketplace manifests, Gemini or Cursor extensions, MCP transport metadata, root release metadata, plugin generation, or agent-facing installation and authentication behavior.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: CLI & MCP for GitHits - The Code Context Layer for AI Coding Agents. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/githits-plugin-maintenance”

Workflow steps

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

  1. Identify the canonical input that owns the requested behavior.
  2. Read docs/implementation/plugin-packaging.md before changing packaging or
  3. Edit canonical inputs only.
  4. For the stable MCP quick-start guide, keep
  5. Run bun run plugins:generate.
  6. Inspect every generated diff and confirm it follows from the canonical
  7. Run bun run plugins:check.
  8. Run targeted tests, then the required smoke or agent evaluations for the

What it can do on your machine

Read from SKILL.md and the folder at commit bc295b3. 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

    Shell commands in SKILL.md call:

    • bun

    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:

    • mcp.githits.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.

Context cost

Githits Plugin Maintenance loads about 1k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 438 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from githits-com/githits-cli at commit bc295b3, republished under its Apache-2.0 licence (© githits-com). 438 words, ~1,016 tokens.

Download SKILL.mdSave it as .claude/skills/githits-plugin-maintenance/SKILL.md (or your agent's skills folder).
name
githits-plugin-maintenance
description
Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces. Use only while working in the githits-cli repository when changing skills, agent guidance, plugin or marketplace manifests, Gemini or Cursor extensions, MCP transport metadata, root release metadata, plugin generation, or agent-facing installation and authentication behavior.
metadata.internal
true

Maintain GitHits Plugin Surfaces

This is an internal, repository-only skill. Do not publish or package it with the public skills under skills/.

Keep root skills and shared metadata canonical. Treat generated manifests and host MCP files as reviewable build artifacts, not authoring locations.

Workflow

  1. Identify the canonical input that owns the requested behavior.
  2. Read docs/implementation/plugin-packaging.md before changing packaging or transport behavior.
  3. Edit canonical inputs only.
  4. For the stable MCP quick-start guide, keep packages/mcp/src/mcp/instructions.ts buildMcpQuickStart() and the terminal ## Quick-start guide section in skills/githits-mcp/SKILL.md byte-for-byte aligned in the same PR. src/skills-packaging.test.ts is the exact-parity contract; exclude buildLocalMcpQuickStart() runtime appendices from the public copy. Route behavior-dependent guide changes through the public Agent Skill lifecycle.
  5. Run bun run plugins:generate.
  6. Inspect every generated diff and confirm it follows from the canonical change.
  7. Run bun run plugins:check.
  8. Run targeted tests, then the required smoke or agent evaluations for the affected surface.

Canonical Ownership

  • Author public skill content only under skills/.
  • Author shared agent guidance in AGENTS.md; keep CLAUDE.md and GEMINI.md as symlinks to it.
  • packages/mcp/src/mcp/instructions.ts owns the stable quick-start builder; the terminal guide in skills/githits-mcp/SKILL.md is its exact public copy.
  • Use package.json for root version, identity, and shared package metadata.
  • Use server.json for registry transports and the hosted MCP endpoint.
  • Use scripts/generate-plugin-assets.ts for host rendering and validation.
Show full SKILL.md (219 more words)Show less

Transport Contract

  • Every plugin and extension package uses https://mcp.githits.com. Claude, Codex, Cursor, and VS Code/GitHub Copilot OpenPlugin share generated .mcp.json; Gemini uses gemini-extension.json with httpUrl; and Antigravity uses mcp_config.json with serverUrl.
  • The hosted server lives in the separate remote-mcp repository and consumes released @githits/mcp for tool registration, descriptors, quick_start, and tool logic. Keep transport, request-scoped service composition, auth/session handling, deployment, and observability in remote-mcp; never reimplement package-owned MCP behavior there. Hosted descriptor changes take effect only after the package release is adopted and deployed by remote-mcp.
  • Direct githits init configuration retains stdio except for Cursor, which is remote-only. Claude and Gemini CLI setup remove legacy plugin or extension state before installing the user-scoped stdio server.
  • server.json advertises both remote and version-pinned npm stdio transports.

Do not change another host's transport without an explicit product decision.

Validation

Always run:

bash
bun run plugins:generate
bun run plugins:check
bun test

Also run bun run build before signoff. Run the repository-required smoke suites when MCP, CLI, packaging, auth, or shared agent behavior changes. Run targeted bun run agent:e2e workloads when skills, instructions, descriptions, or agent-facing behavior change.

Guardrails

  • Do not manually patch generated manifests to make a check pass.
  • Do not add authored host-specific skill forks.
  • Do not add Markdown plugin commands unless the command is an intentional, tested product surface.
  • Stop if generated changes cannot be explained by canonical input changes.

© githits-com, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/githits-plugin-maintenance of githits-com/githits-cli.

Open the folder on GitHubat commit bc295b3

Compare with similar skills

Githits Plugin 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.

Githits Plugin Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Githits Plugin Maintenance this skillgithits-com/githits-cli114—~1kAutomated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official37k11 repos~3.1kAutomated safety check: PassApache-2.0
Fastmcp Client CLIPrefectHQ/fastmcp28k1 repos~823Automated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    37k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub starsUsed in 1 repo~823 tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from githits-com/githits-cli

  • Githits Code

    githits-com/githits-cli

    A skill your agent uses whenever invoking the GitHits CLI for public OSS source, documentation, or example evidence, including code search/grep, file navigation, source verification, docs lookup, or…

    114 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Githits Onboarding

    githits-com/githits-cli

    A skill your agent uses when the user asks to install, connect, configure, sign in to, sign up for, or start using GitHits.

    114 GitHub stars~3.5k tokensUpdated yesterday
    Auto-check passed
  • Githits Package

    githits-com/githits-cli

    A skill your agent uses whenever invoking the GitHits CLI for public package or dependency evidence, including metadata, versions, licenses, vulnerabilities, dependency graphs, changelogs, release…

    114 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Braintrust Agent Evals

    githits-com/githits-cli

    Inspect, query, compare, or explicitly export GitHits agent-eval history in Braintrust using the repository's verified workflow.

    114 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Githits Release

    githits-com/githits-cli

    A skill your agent uses when maintaining the GitHits changelog or preparing, reviewing, or executing a GitHits release.

    114 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Githits MCP

    githits-com/githits-cli

    Route public OSS code, documentation, examples, and package questions to GitHits tools.

    114 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Githits Plugin Maintenance

What does Githits Plugin Maintenance do?

Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces. Githits Plugin Maintenance is an agent skill from githits-com/githits-cli. Internal repository-maintenance skill for GitHits cross-host plugin and Agent Skill surfaces.

When should I use Githits Plugin Maintenance?

Githits Plugin Maintenance fits situations like: tasks that involve MCP servers.

How do I install Githits Plugin Maintenance in Claude Code?

Run `npx skills add githits-com/githits-cli --skill githits-plugin-maintenance -a claude-code`. Or copy the skill folder (.agents/skills/githits-plugin-maintenance in githits-com/githits-cli) into .claude/skills/githits-plugin-maintenance in your project. Claude Code loads it when a task matches its description.

How do I install Githits Plugin Maintenance in Codex?

Run `npx skills add githits-com/githits-cli --skill githits-plugin-maintenance -a codex`. Or copy the skill folder (.agents/skills/githits-plugin-maintenance in githits-com/githits-cli) into .agents/skills/githits-plugin-maintenance in your project. Codex loads it when a task matches its description.

Can I use Githits Plugin 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 githits-com/githits-cli --skill githits-plugin-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/githits-plugin-maintenance, .gemini/skills/githits-plugin-maintenance, .github/skills/githits-plugin-maintenance and .opencode/skills/githits-plugin-maintenance in your project.

What does Githits Plugin Maintenance need to run?

Going by SKILL.md and its folder, Githits Plugin Maintenance needs the command-line tools its instructions call (bun).

Does Githits Plugin Maintenance access the network?

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

Is Githits Plugin 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. Review the folder before installing.

What licence does Githits Plugin Maintenance use?

Githits Plugin Maintenance is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Githits Plugin Maintenance use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Githits Plugin Maintenance?

Skills that share tags, products or a category with Githits Plugin Maintenance: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 37k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Githits Plugin Maintenance?

githits-com (a GitHub organization) maintains it in githits-com/githits-cli, which has 114 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 6, 2026.

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