Skip to content

chore: add agent skills for common development workflows#210

Open
cleithner-comcast wants to merge 6 commits intomainfrom
cleith/dev/addSkills
Open

chore: add agent skills for common development workflows#210
cleithner-comcast wants to merge 6 commits intomainfrom
cleith/dev/addSkills

Conversation

@cleithner-comcast
Copy link
Copy Markdown
Contributor

Add 7 SKILL.md files following the agentskills.io open standard:

  • build: build.sh, cmake, matter build hierarchy
  • run-unit-tests: ctest with CMocka/GTest
  • run-integration-tests: pytest via py_test.sh with ASAN
  • matter-virtual-devices: sample apps, chip-tool, matter.js
  • validate-sbmd: schema validation and stub generation
  • format-code: clang-format and blank-line conventions
  • debug: gdb, pdb/debugpy, and gdb+python workflows

Archive the add-agent-skills OpenSpec change and sync delta specs to openspec/specs/.

Add 7 SKILL.md files following the agentskills.io open standard:
- build: build.sh, cmake, matter build hierarchy
- run-unit-tests: ctest with CMocka/GTest
- run-integration-tests: pytest via py_test.sh with ASAN
- matter-virtual-devices: sample apps, chip-tool, matter.js
- validate-sbmd: schema validation and stub generation
- format-code: clang-format and blank-line conventions
- debug: gdb, pdb/debugpy, and gdb+python workflows

Archive the add-agent-skills OpenSpec change and sync delta
specs to openspec/specs/.
Copy link
Copy Markdown
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

Adds a set of Agent Skills (agentskills.io) docs and corresponding OpenSpec requirements/archival artifacts so coding agents can reliably build, test, debug, format, and work with Matter/SBMD workflows in the BartonCore dev container.

Changes:

  • Introduce new .github/skills/*/SKILL.md operational skills for unit tests, integration tests, Matter virtual devices, SBMD validation, formatting, and debugging.
  • Add OpenSpec “agent-skill-*” requirement specs (plus an archived change bundle) describing expected content/behavior of those skills.
  • Archive the “add agent skills” OpenSpec change (proposal/design/tasks + copied specs).

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 13 comments.

Show a summary per file
File Description
openspec/specs/agent-skill-validate-sbmd/spec.md New OpenSpec requirements for the validate-sbmd skill
openspec/specs/agent-skill-unit-tests/spec.md New OpenSpec requirements for the run-unit-tests skill
openspec/specs/agent-skill-matter-devices/spec.md New OpenSpec requirements for the matter-virtual-devices skill
openspec/specs/agent-skill-integration-tests/spec.md New OpenSpec requirements for the run-integration-tests skill
openspec/specs/agent-skill-format-code/spec.md New OpenSpec requirements for the format-code skill
openspec/specs/agent-skill-debug/spec.md New OpenSpec requirements for the debug skill
openspec/specs/agent-skill-build/spec.md New OpenSpec requirements for the build skill
openspec/changes/archive/2026-04-21-add-agent-skills/tasks.md Archived task checklist for the change
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-validate-sbmd/spec.md Archived copy of validate-sbmd OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-unit-tests/spec.md Archived copy of unit-tests OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-matter-devices/spec.md Archived copy of matter-devices OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-integration-tests/spec.md Archived copy of integration-tests OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-format-code/spec.md Archived copy of format-code OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-debug/spec.md Archived copy of debug OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/specs/agent-skill-build/spec.md Archived copy of build OpenSpec requirements
openspec/changes/archive/2026-04-21-add-agent-skills/proposal.md Archived proposal describing the change and intended skill set
openspec/changes/archive/2026-04-21-add-agent-skills/design.md Archived design write-up and rationale
openspec/changes/archive/2026-04-21-add-agent-skills/.openspec.yaml Archive metadata for the OpenSpec change
.github/skills/validate-sbmd/SKILL.md Agent skill doc for SBMD validation + stub generation
.github/skills/run-unit-tests/SKILL.md Agent skill doc for running/filtering CTest unit tests
.github/skills/run-integration-tests/SKILL.md Agent skill doc for running/filtering pytest integration tests via py_test.sh
.github/skills/matter-virtual-devices/SKILL.md Agent skill doc for CHIP sample apps, chip-tool, and matter.js virtual devices
.github/skills/format-code/SKILL.md Agent skill doc for clang-format + repo-specific blank-line rules
.github/skills/debug/SKILL.md Agent skill doc for gdb/pdb workflows (native + Python-driven)

Comment thread openspec/specs/agent-skill-build/spec.md
Comment thread openspec/changes/archive/2026-04-21-add-agent-skills/tasks.md
Comment thread openspec/specs/agent-skill-validate-sbmd/spec.md
Comment thread openspec/specs/agent-skill-validate-sbmd/spec.md
Comment thread openspec/specs/agent-skill-unit-tests/spec.md
Comment thread .github/skills/debug/SKILL.md
Comment thread .github/skills/debug/SKILL.md Outdated
Add .github/.gitignore with a negation rule for skills/build/ so
the build skill is not excluded by the top-level build ignore pattern.
Add the previously-ignored build skill.
@cleithner-comcast
Copy link
Copy Markdown
Contributor Author

@copilot apply changes based on the comments in this thread

2 similar comments
@cleithner-comcast
Copy link
Copy Markdown
Contributor Author

@copilot apply changes based on the comments in this thread

@cleithner-comcast
Copy link
Copy Markdown
Contributor Author

@copilot apply changes based on the comments in this thread

Agent-Logs-Url: https://github.com/rdkcentral/BartonCore/sessions/7028387f-c4cb-48e8-b3f3-cd748af402bc

Co-authored-by: cleithner-comcast <87389808+cleithner-comcast@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 23, 2026 13:36
@cleithner-comcast cleithner-comcast review requested due to automatic review settings April 23, 2026 13:36
Agent-Logs-Url: https://github.com/rdkcentral/BartonCore/sessions/7028387f-c4cb-48e8-b3f3-cd748af402bc

Co-authored-by: cleithner-comcast <87389808+cleithner-comcast@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 23, 2026 13:38
@cleithner-comcast cleithner-comcast review requested due to automatic review settings April 23, 2026 13:38
Agent-Logs-Url: https://github.com/rdkcentral/BartonCore/sessions/7028387f-c4cb-48e8-b3f3-cd748af402bc

Co-authored-by: cleithner-comcast <87389808+cleithner-comcast@users.noreply.github.com>
Copilot AI review requested due to automatic review settings April 23, 2026 13:39
@cleithner-comcast cleithner-comcast review requested due to automatic review settings April 23, 2026 13:39
Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 23, 2026

@copilot apply changes based on the comments in this thread

Applied the requested review-thread updates in commits ccc4cd0, ecb637f, and 22232b7 (unit-test path fixes and debug skill command/breakpoint corrections).

@copilot apply changes based on the comments in this thread

Applied the requested review-thread updates in commits ccc4cd0, ecb637f, and 22232b7 (unit-test path fixes and debug skill command/breakpoint corrections).

@copilot apply changes based on the comments in this thread

Applied the requested review-thread updates in commits ccc4cd0, ecb637f, and 22232b7 (unit-test path fixes and debug skill command/breakpoint corrections).

Copy link
Copy Markdown
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

Copilot reviewed 26 out of 26 changed files in this pull request and generated 10 comments.

Comment thread .github/skills/build/SKILL.md
Comment thread .github/skills/build/SKILL.md
Comment thread .github/skills/validate-sbmd/SKILL.md
Comment thread .github/skills/validate-sbmd/SKILL.md
Comment thread .github/skills/run-unit-tests/SKILL.md
Comment thread .github/skills/debug/SKILL.md
Comment thread .github/.gitignore
Comment thread .github/skills/run-integration-tests/SKILL.md
Comment thread .github/skills/matter-virtual-devices/SKILL.md
Comment thread openspec/specs/agent-skill-validate-sbmd/spec.md
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.

4 participants