Skip to content

Add agr-cli and skill-debrief skills#519

Merged
kasperjunge merged 2 commits into
mainfrom
skills/add-agr-cli-and-improve-skill
May 1, 2026
Merged

Add agr-cli and skill-debrief skills#519
kasperjunge merged 2 commits into
mainfrom
skills/add-agr-cli-and-improve-skill

Conversation

@kasperjunge
Copy link
Copy Markdown
Collaborator

@kasperjunge kasperjunge commented May 1, 2026

Summary

Adds two new in-repo skills under skills/:

  • agr-cli — helps an agent operate the agr CLI on the user's behalf: set up new repos, install/sync/upgrade/remove skills, manage agr.toml / agr.lock, and scaffold in-repo skills under skills/. Thin SKILL.md index pointing at 8 workflow-oriented references (setup, handles, installing-skills, syncing, in-repo-skills, configuration, running-skills, troubleshooting).
  • skill-debrief — debrief an existing skill after using it: capture session feedback or a retrospective and fold it back in. Listens, proposes, aligns with the user, applies the edit, commits with skill(<name>): ... style, and runs agr upgrade <name> to re-install. For remote skills, offers to file an issue upstream via gh or fork to in-repo.

Both skills are self-contained: they call agr directly and have no hard dependency on each other or on agr-release. Cross-references are described by capability, not by skill name, so each works installed standalone.

Design notes

  • Frontmatter: minimal (name, description only) to match the existing agr-release skill.
  • Description triggers: both skills list explicit user phrases that should fire them (the description is the only trigger signal, so it's deliberately pushy). skill-debrief triggers on "debrief X", "retrospective on X", "feedback on X", "improve X", etc.
  • References strategy: agr-cli follows the progressive-disclosure pattern — short SKILL.md, one workflow-oriented references/<topic>.md per concern. skill-debrief is a single SKILL.md (focused workflow, no need for split).
  • skill-debrief workflow: explicit-only trigger, listens (does not interrogate), proposes specific edits, waits for user approval, commits without pushing, runs agr upgrade (not agr sync — local-path skills need re-copy). For remote skills, prefers upstream gh issue create with confirmed title/body, offers fork-to-in-repo as fallback.

Commits

  1. feat: add agr-cli and improve-skill skills — initial implementation.
  2. refactor: rename improve-skill to skill-debrief — rename for clearer semantic signal ("debrief" reads more naturally as end-of-session retrospective and matches skill-creator naming style). Squash on merge.

Test plan

  • agr add ./skills/agr-cli installs cleanly into configured tools
  • agr add ./skills/skill-debrief installs cleanly
  • agr-cli triggers correctly on phrases like "install the pdf skill", "set up agr in this repo", "agr.toml is broken"
  • skill-debrief triggers on "debrief the X skill", "retrospective on X", "feedback on X", "improve the X skill" — and does NOT over-fire on casual mentions of skills
  • In a fresh project, agr-cli can guide an end-to-end setup: agr init, scaffold an in-repo skill, register it, sync
  • skill-debrief end-to-end: edit an in-repo skill based on feedback, commit with skill(<name>): ..., agr upgrade <name>, no push
  • skill-debrief correctly handles a remote-skill case (offers gh issue create and/or fork-to-in-repo)

🤖 Generated with Claude Code

Kasper Junge and others added 2 commits May 1, 2026 08:32
Two new in-repo skills under skills/:

- agr-cli: helps an agent operate the agr CLI on the user's behalf —
  set up new repos, install/sync/upgrade skills, manage agr.toml /
  agr.lock, and scaffold in-repo skills under skills/. Thin SKILL.md
  index pointing at 8 workflow-oriented references (setup, handles,
  installing-skills, syncing, in-repo-skills, configuration,
  running-skills, troubleshooting).

- improve-skill: retrospective-driven loop for updating an existing
  skill based on session feedback. Listens, proposes, aligns, applies,
  commits, and runs `agr upgrade` to re-install. For remote skills,
  offers to file an issue upstream via `gh` or fork to in-repo.

Both skills are self-contained — they call `agr` directly and have no
hard dependency on each other or on agr-release.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Rename for clearer semantic signal: "debrief" reads more naturally as
end-of-session feedback / retrospective on a skill, and matches the
`skill-creator` naming style. Adds "debrief"-flavored trigger phrases
to the description and the When-to-use list while keeping all earlier
trigger phrases (improve, retrospective, feedback, …) so existing
invocations still fire.

Updates the cross-reference in agr-cli/SKILL.md to point at
`skill-debrief`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@kasperjunge kasperjunge changed the title Add agr-cli and improve-skill skills Add agr-cli and skill-debrief skills May 1, 2026
@kasperjunge kasperjunge merged commit e7d33b2 into main May 1, 2026
2 of 3 checks passed
@kasperjunge kasperjunge deleted the skills/add-agr-cli-and-improve-skill branch May 1, 2026 06:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant