Skip to content

feat: Auto-register ai-skills for extensions whenever applicable#1840

Draft
dhilipkumars wants to merge 1 commit intogithub:mainfrom
dhilipkumars:add-ext-skills
Draft

feat: Auto-register ai-skills for extensions whenever applicable#1840
dhilipkumars wants to merge 1 commit intogithub:mainfrom
dhilipkumars:add-ext-skills

Conversation

@dhilipkumars
Copy link
Contributor

@dhilipkumars dhilipkumars commented Mar 13, 2026

Description

Testing

  • Tested locally with uv run specify --help
  • Ran existing tests with uv sync && uv run pytest
  • Tested with a sample project (if applicable)

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

Fixes: #1795

@dhilipkumars dhilipkumars requested a review from mnriem as a code owner March 13, 2026 23:30
Copilot AI review requested due to automatic review settings March 13, 2026 23:30
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds automatic agent-skill (agentskills.io) generation for extension commands when a project was initialized with --ai-skills, and ensures those skills are tracked and cleaned up on extension removal.

Changes:

  • Add skill directory detection plus skill register/unregister hooks to ExtensionManager (tracked in extension registry metadata).
  • Update CLI output and docs to surface skill auto-registration behavior.
  • Add comprehensive unit tests for skill creation, YAML parsing, non-overwrite behavior, and removal cleanup (including fallback cleanup when init-options change).

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
tests/test_extension_skills.py Adds unit tests covering extension skill auto-registration and cleanup behaviors.
src/specify_cli/extensions.py Implements skill dir lookup, skill generation for extension commands, registry tracking, and uninstall cleanup (with fallback scan).
src/specify_cli/__init__.py Updates extension add/remove CLI output to include registered skill counts.
extensions/EXTENSION-USER-GUIDE.md Documents the new auto-registration behavior for agent skills.
README.md Updates --ai-skills option description to mention extension command auto-registration.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

for cmd_info in manifest.commands:
cmd_name = cmd_info["name"]
cmd_file_rel = cmd_info["file"]
source_file = extension_dir / cmd_file_rel
Comment on lines +524 to +529

skill_content = (
f"---\n"
f"{frontmatter_text}\n"
f"---\n\n"
f"# {skill_name.replace('-', ' ').replace('.', ' ').title()} Skill\n\n"
@dhilipkumars dhilipkumars marked this pull request as draft March 13, 2026 23:34
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.

Feature Request: Auto-register extensions as Agent Skills

2 participants