Skip to content

feat(skills): add portable agent skills#133

Merged
mattnorris merged 2 commits into
mainfrom
skills
Jul 21, 2026
Merged

feat(skills): add portable agent skills#133
mattnorris merged 2 commits into
mainfrom
skills

Conversation

@mattnorris

Copy link
Copy Markdown
Collaborator

Summary

Adds a portable Agent Skills library under skills/ess/ with four host-neutral workflows (PR review automation, MCP secret externalization, and changelog summarization), plus install docs and CI validation against the agentskills.io spec.

Changes

  • Add four skills under skills/ess/:
    • pr-address-comments — read GitHub PR review threads, implement fixes, reply and resolve via GraphQL
    • pr-address-comments-all — batch variant using per-PR git worktrees and background subagents
    • mcp-hide-secrets — move Cursor MCP credentials from mcp.json into a LaunchAgent-loaded mcp.env (macOS)
    • summarize-change-log — condense long git logs into 1–5 Conventional Commit bullets with validation scripts
  • Add skills/README.md with install matrix (npx skills add) for Cursor, Claude Code, and Codex
  • Add .github/workflows/validate-skills.yml — runs skills-ref validate on every SKILL.md under skills/ on PRs touching that tree
  • Ignore agent-skills CLI install output (.agents/skills/, skills-lock.json) in .gitignore

Files Changed

File Change Type Description
skills/README.md Added Install matrix and skill index
skills/ess/pr-address-comments/ Added Single-PR review comment workflow
skills/ess/pr-address-comments-all/ Added Parallel multi-PR workflow with worktree scripts
skills/ess/mcp-hide-secrets/ Added MCP secret externalization skill + install scripts
skills/ess/summarize-change-log/ Added Changelog summarizer + validator
.github/workflows/validate-skills.yml Added CI validation via skills-ref
.gitignore Modified Ignore .agents/skills/ and skills-lock.json

Testing

Local Testing

  • Skills committed with valid SKILL.md frontmatter (name, description)
  • Each skill includes Apache 2.0 LICENSE
  • Run skills-ref validate locally on each skill (CI will run on PR open)
  • Smoke-test install: npx skills add ./skills --list

CI

  • Validate Skills workflow passes on this PR (paths filter: skills/**)

Checklist

  • Skills are host-neutral (no IDE-specific frontmatter committed)
  • README documents install paths for Cursor / Claude / Codex
  • Reviewers assigned via CODEOWNERS

Deployment Notes

Documentation and CI only — no runtime deployment. Consumers install via npx skills add CiscoDevNet/essentials --skill '*'.

Related PRs

None

Made with Cursor

Add four Agent Skills under skills/ess/ (pr-address-comments,
pr-address-comments-all, mcp-hide-secrets, summarize-change-log), each with a
LICENSE, plus skills/README.md with an install matrix and a validate-skills
workflow that runs skills-ref validate on every skill under skills/.
Verified npx skills add installs all four skills; the CLI needs
--full-depth to discover skills under skills/ess/.
@mattnorris
mattnorris merged commit b6b9903 into main Jul 21, 2026
2 checks passed
@mattnorris
mattnorris deleted the skills branch July 21, 2026 03:43
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