provide a skill for agents to use gotcha from the command line #45

New Issue

hugo · 2026-07-31T18:51:43Z

hugo commented

2026-07-31 18:51:43 +00:00

there should be a command to manage a skill that provides agents with the needed information to properly use gotcha. commands and subcommands:

gotcha skill install <agent> installs the skill into the given agent
gotcha skill uninstall <agent> uninstalls the skill from the given agent
gotcha skill uninstall uninstalls the skill from all agents where it is installed
gotcha skill status shows what agents have the skill installed
gotcha skill update updates the skill in agents that have it installed to the newest version

the skill is embedded into the executable - it should stay a one-executable distribution.

Supported agents:

claude (cli and desktop - might require two different agent names?)
codex (cli and desktop)
github copilot cli
opencode
pi

the skill should give the agents all relevant information to efficiently work with issues, pull requests, milestones. it will be extended later for additional features.

The skill also should talk about limits of the tooling, like for example possible paging and things like that. make sure that the actual usecase is working in that the agent can pull a full list of issues, even if only with multiple calls.

there should be a command to manage a skill that provides agents with the needed information to properly use gotcha. commands and subcommands: - ```gotcha skill install <agent>``` installs the skill into the given agent - ```gotcha skill uninstall <agent>``` uninstalls the skill from the given agent - ```gotcha skill uninstall``` uninstalls the skill from all agents where it is installed - ```gotcha skill status``` shows what agents have the skill installed - ```gotcha skill update``` updates the skill in agents that have it installed to the newest version the skill is embedded into the executable - it should stay a one-executable distribution. Supported agents: - claude (cli and desktop - might require two different agent names?) - codex (cli and desktop) - github copilot cli - opencode - pi the skill should give the agents all relevant information to efficiently work with issues, pull requests, milestones. it will be extended later for additional features. The skill also should talk about limits of the tooling, like for example possible paging and things like that. make sure that the actual usecase is working in that the agent can pull a full list of issues, even if only with multiple calls.

hugo added this to the first public release milestone 2026-07-31 18:51:43 +00:00

hugo added the enhancement label 2026-07-31 18:51:43 +00:00

hugo added the wontfix label 2026-07-31 19:15:03 +00:00

hugo commented

2026-07-31 19:15:42 +00:00

actually too much work and too fragile - it is hard to recognize self-hosted gitea sites, it is much easier to just tell the LLM to use gotcha in the AGENTS.md and be done with it. the gotcha help is already quite descriptive for an AI.

hugo closed this issue

2026-07-31 19:15:43 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: hugo/Gotcha#45