Add agr-cli and skill-debrief skills#519
Merged
Merged
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds two new in-repo skills under
skills/:agr-cli— helps an agent operate theagrCLI on the user's behalf: set up new repos, install/sync/upgrade/remove skills, manageagr.toml/agr.lock, and scaffold in-repo skills underskills/. ThinSKILL.mdindex 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 withskill(<name>): ...style, and runsagr upgrade <name>to re-install. For remote skills, offers to file an issue upstream viaghor fork to in-repo.Both skills are self-contained: they call
agrdirectly and have no hard dependency on each other or onagr-release. Cross-references are described by capability, not by skill name, so each works installed standalone.Design notes
name,descriptiononly) to match the existingagr-releaseskill.descriptionis the only trigger signal, so it's deliberately pushy).skill-debrieftriggers on "debrief X", "retrospective on X", "feedback on X", "improve X", etc.agr-clifollows the progressive-disclosure pattern — short SKILL.md, one workflow-orientedreferences/<topic>.mdper concern.skill-debriefis a single SKILL.md (focused workflow, no need for split).skill-debriefworkflow: explicit-only trigger, listens (does not interrogate), proposes specific edits, waits for user approval, commits without pushing, runsagr upgrade(notagr sync— local-path skills need re-copy). For remote skills, prefers upstreamgh issue createwith confirmed title/body, offers fork-to-in-repo as fallback.Commits
feat: add agr-cli and improve-skill skills— initial implementation.refactor: rename improve-skill to skill-debrief— rename for clearer semantic signal ("debrief" reads more naturally as end-of-session retrospective and matchesskill-creatornaming style). Squash on merge.Test plan
agr add ./skills/agr-cliinstalls cleanly into configured toolsagr add ./skills/skill-debriefinstalls cleanlyagr-clitriggers correctly on phrases like "install the pdf skill", "set up agr in this repo", "agr.toml is broken"skill-debrieftriggers on "debrief the X skill", "retrospective on X", "feedback on X", "improve the X skill" — and does NOT over-fire on casual mentions of skillsagr-clican guide an end-to-end setup:agr init, scaffold an in-repo skill, register it, syncskill-debriefend-to-end: edit an in-repo skill based on feedback, commit withskill(<name>): ...,agr upgrade <name>, no pushskill-debriefcorrectly handles a remote-skill case (offersgh issue createand/or fork-to-in-repo)🤖 Generated with Claude Code