Merge pull request cli#13165 from cli/sm/add-skills-command

Add agent skills command

Author: BagToad

.gitignore

@@ -38,3 +38,4 @@
 *~
 
 vendor/
+gh

acceptance/acceptance_test.go

@@ -14,9 +14,9 @@ import (
 
 	"math/rand"
 
+	"github.com/MakeNowJust/heredoc"
 	"github.com/cli/cli/v2/internal/ghcmd"
 	"github.com/cli/go-internal/testscript"
-	"github.com/MakeNowJust/heredoc"
 )
 
 func ghMain() int {
@@ -434,3 +434,11 @@ func (e *testScriptEnv) fromEnv() error {
 
 	return nil
 }
+
+func TestSkills(t *testing.T) {
+	var tsEnv testScriptEnv
+	if err := tsEnv.fromEnv(); err != nil {
+		t.Fatal(err)
+	}
+	testscript.Run(t, testScriptParamsFor(tsEnv, "skills"))
+}

acceptance/testdata/skills/skills-install-force.txtar

@@ -0,0 +1,11 @@
+# Install with --force should overwrite an existing skill without error
+exec gh skill install github/awesome-copilot git-commit --force --dir $WORK/force-test
+stdout 'Installed git-commit'
+
+# Install again with --force — should succeed (overwrite)
+exec gh skill install github/awesome-copilot git-commit --force --dir $WORK/force-test
+stdout 'Installed git-commit'
+
+# Without --force, non-interactive should fail when skill exists
+! exec gh skill install github/awesome-copilot git-commit --dir $WORK/force-test
+stderr 'already installed'

acceptance/testdata/skills/skills-install-from-local.txtar

@@ -0,0 +1,15 @@
+# Install from a local directory using --from-local
+exec gh skill install --from-local $WORK/local-repo git-commit --dir $WORK/output --force
+stdout 'Installed git-commit'
+
+# Verify the skill was copied
+exists $WORK/output/git-commit/SKILL.md
+grep 'local-path' $WORK/output/git-commit/SKILL.md
+
+-- local-repo/skills/git-commit/SKILL.md --
+---
+name: git-commit
+description: Write good git commits
+---
+# Git Commit
+Body content.

acceptance/testdata/skills/skills-install-invalid-agent.txtar

@@ -0,0 +1,4 @@
+# Invalid agent ID should error with valid options
+! exec gh skill install github/awesome-copilot git-commit --agent bogus-agent --force
+stderr 'invalid argument'
+stderr 'github-copilot'

acceptance/testdata/skills/skills-install-invalid-repo.txtar

@@ -0,0 +1,3 @@
+# Nonexistent repo should error
+! exec gh skill install nonexistent-owner-xyz/nonexistent-repo-abc --force --dir $WORK/tmp
+stderr 'Not Found'

acceptance/testdata/skills/skills-install-namespaced.txtar

@@ -0,0 +1,60 @@
+# Two namespaced skills with the same base name in the same repo should
+# be independently installable using path-based disambiguation.
+
+# Use gh as a credential helper
+exec gh auth setup-git
+
+# Create a repo with two namespaced skills that share the name "deploy"
+exec gh repo create $ORG/$SCRIPT_NAME-$RANDOM_STRING --public --add-readme
+defer gh repo delete --yes $ORG/$SCRIPT_NAME-$RANDOM_STRING
+
+exec gh repo clone $ORG/$SCRIPT_NAME-$RANDOM_STRING
+cd $SCRIPT_NAME-$RANDOM_STRING
+
+mkdir -p skills/alice/deploy
+mkdir -p skills/bob/deploy
+cp $WORK/alice-skill.md skills/alice/deploy/SKILL.md
+cp $WORK/bob-skill.md skills/bob/deploy/SKILL.md
+
+exec git add -A
+exec git commit -m 'Add namespaced skills'
+exec git push origin main
+
+# Publish so the skills are discoverable
+exec gh skill publish --tag v1.0.0
+
+# Install alice's deploy skill using the full path to disambiguate
+exec gh skill install $ORG/$SCRIPT_NAME-$RANDOM_STRING skills/alice/deploy --scope user --force
+stdout 'Installed alice/deploy'
+
+# Install bob's deploy skill using the full path
+exec gh skill install $ORG/$SCRIPT_NAME-$RANDOM_STRING skills/bob/deploy --scope user --force
+stdout 'Installed bob/deploy'
+
+# Verify both were installed to separate directories
+exists $HOME/.copilot/skills/alice/deploy/SKILL.md
+exists $HOME/.copilot/skills/bob/deploy/SKILL.md
+
+# Verify each has the correct content
+grep 'Alice' $HOME/.copilot/skills/alice/deploy/SKILL.md
+grep 'Bob' $HOME/.copilot/skills/bob/deploy/SKILL.md
+
+-- alice-skill.md --
+---
+name: deploy
+description: Alice's deployment skill
+---
+
+# Deploy by Alice
+
+Deploys infrastructure using Alice's conventions.
+
+-- bob-skill.md --
+---
+name: deploy
+description: Bob's deployment skill
+---
+
+# Deploy by Bob
+
+Deploys infrastructure using Bob's conventions.

acceptance/testdata/skills/skills-install-nested-files.txtar

@@ -0,0 +1,3 @@
+# Install a skill that has nested subdirectories and verify file tree
+exec gh skill install github/awesome-copilot git-commit --force --dir $WORK/nested-test
+exists $WORK/nested-test/git-commit/SKILL.md

acceptance/testdata/skills/skills-install-nonexistent-skill.txtar

@@ -0,0 +1,3 @@
+# Installing a skill that doesn't exist in a valid repo should error
+! exec gh skill install github/awesome-copilot nonexistent-skill-xyz --force --dir $WORK/tmp
+stderr 'not found'

acceptance/testdata/skills/skills-install-pin.txtar

@@ -0,0 +1,7 @@
+# Install with --pin to a specific ref
+exec gh skill install github/awesome-copilot git-commit --scope user --force --pin main
+stdout 'Installed git-commit'
+
+# Install without --pin should resolve latest version
+exec gh skill install github/awesome-copilot git-commit --scope user --force
+stdout 'Installed git-commit'