Skip to content

Add usethis-cli-modify agent skill#1555

Merged
nathanjmcdougall merged 3 commits intomainfrom
copilot/add-usethis-cli-modify-skill
Mar 25, 2026
Merged

Add usethis-cli-modify agent skill#1555
nathanjmcdougall merged 3 commits intomainfrom
copilot/add-usethis-cli-modify-skill

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 25, 2026

Agents modifying the _ui layer were not updating the manually-written CLI documentation. This adds a dedicated skill to enforce that discipline.

  • New skill .agents/skills/usethis-cli-modify/SKILL.md:
    • Scoped to any modification of the _ui package (commands, options, help text, app registration)
    • Enumerates all docs that must be reviewed on CLI changes: command reference, command overview, example/getting-started pages, README, CONTRIBUTING.md
    • Documents CLI architecture (interface/core separation, command registration pattern)
  • Updated AGENTS.md: Added usethis-cli-modify to the important skills list so agents are directed to it for any _ui layer work
Original prompt

This section details on the original issue you should resolve

<issue_title>Provide agent skill instructions on how to modify the CLI</issue_title>
<issue_description>@copilot you need to update the docs too

Originally posted by @nathanjmcdougall in #1538 (comment)

We need to put emphasis on the need to update the docs after modifying anything in the usethis._ui layer. Probably a new agent skill called usethis-cli-modify
</issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Creates a new skill that guides agents on modifying the CLI layer and
emphasizes the requirement to update documentation (reference docs,
overview, examples, README, CONTRIBUTING.md) after any user-facing
CLI changes. Also registers the skill as important in AGENTS.md.

Co-authored-by: nathanjmcdougall <18602289+nathanjmcdougall@users.noreply.github.com>
Agent-Logs-Url: https://github.com/usethis-python/usethis-python/sessions/d8b3f256-7b6c-4eab-8d72-80f242b62ced
Copilot AI changed the title [WIP] Add agent skill instructions for modifying CLI Add usethis-cli-modify agent skill Mar 25, 2026
Copilot AI requested a review from nathanjmcdougall March 25, 2026 21:22
@nathanjmcdougall nathanjmcdougall marked this pull request as ready for review March 25, 2026 22:13
@nathanjmcdougall nathanjmcdougall merged commit 7ef283a into main Mar 25, 2026
@nathanjmcdougall nathanjmcdougall deleted the copilot/add-usethis-cli-modify-skill branch March 25, 2026 22:13
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.

Provide agent skill instructions on how to modify the CLI

2 participants