Skip to content

Add Copilot code-review agent skill - #67

Merged
tonythethompson merged 3 commits into
mainfrom
agent/add-code-review-skill
Aug 8, 2026
Merged

Add Copilot code-review agent skill#67
tonythethompson merged 3 commits into
mainfrom
agent/add-code-review-skill

Conversation

@tonythethompson

@tonythethompson tonythethompson commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add .github/skills/code-review/SKILL.md so GitHub Copilot code review loads Trackdub public-core review guidance (directory name code-review per GitHub docs).
  • Un-ignore .github/skills/code-review/** in .gitignore while keeping other local skill overlays ignored.
  • Skill points reviewers at root REVIEW.md, dependency-direction / readiness / model-license stops, and honest test evidence.

Fixes TS-161

Linked issue

  • Closes TS-161 (paired with Trackdub-gated PR)

Scope

  • Single-responsibility change
  • No unrelated refactors included

Testing

  • dotnet build Trackdub.slnx -m:1
  • dotnet test Trackdub.slnx -m:1
  • Targeted tests only
  • Not run, with justification below

Test notes

Docs-only / agent-skill addition. No code or build surface changed. Verified file tracks after .gitignore exception and is present on the PR head branch.

Architecture review

  • No layer dependency violation introduced
  • No inference code added to Trackdub.App
  • No persistence added to view models
  • No pipeline truth moved into UI state
  • No state mutation added from model wrappers

License/model impact

  • No new third-party dependency
  • No new model or model asset
  • New dependency/model documented
  • Manifest/license requirements reviewed
  • Commercial-safe mode impact reviewed

Risk and rollback

  • Low-risk change
  • Rollback is straightforward
  • Follow-up work required, noted below

Milestone notes

Platform & Tooling: Copilot code review skills for public core.

Agent notes

Paired PR in trackdubllc/Trackdub-gated adds the gated desktop skill.

Made with Cursor

Review in cubic

Note

Add Copilot code-review agent skill for Trackdub public core

Adds SKILL.md, a Markdown specification that instructs the Copilot code-review agent on review priorities, automatic stop conditions, checklist areas (architecture, pipeline/readiness, models/licensing, tests), comment style, and merge criteria. Updates .gitignore to stop ignoring the new code-review/ directory while continuing to ignore other skill directories.

Macroscope summarized 4db108a.

Summary by CodeRabbit

  • Documentation

    • Added guidance for reviewing code in the Trackdub public core.
    • Documented review priorities, testing expectations, architecture checks, licensing requirements, comment standards, and merge-readiness criteria.
    • Standardized criteria for identifying issues that require changes before merging.
  • Chores

    • Updated repository ignore rules to manage code-review guidance files appropriately.
    • Preserved visibility for the newly added code-review guidance while excluding other skill files.

Track .github/skills/code-review so Copilot code review can load Trackdub REVIEW.md guidance, and keep other local skill overlays ignored.

Co-authored-by: Cursor <cursoragent@cursor.com>
Copilot AI lite review requested due to automatic review settings August 8, 2026 04:01
@linear-code

linear-code Bot commented Aug 8, 2026

Copy link
Copy Markdown

TS-161

@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This change adds a Trackdub public-core code-review skill. It defines review scope, checks, stop conditions, testing guidance, comment standards, and merge criteria. Git ignore rules now include the code-review skill directory.

Changes

Code-review skill setup

Layer / File(s) Summary
Define and include the code-review skill
.github/skills/code-review/SKILL.md, .gitignore
The repository now contains a code-review skill specification. .gitignore ignores other skill files while allowing the code-review directory and its contents.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related issues

  • trackdubllc/portal.trackdub#54 — The pull request adds the requested code-review skill and configures its Git ignore rules.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly identifies the main change: adding a Copilot code-review agent skill.
Description check ✅ Passed The description follows the repository template and documents scope, testing, architecture, impact, risk, issue linkage, and milestone details.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/add-code-review-skill
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch agent/add-code-review-skill

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@greptile-apps

greptile-apps Bot commented Aug 8, 2026

Copy link
Copy Markdown

Greptile Summary

This PR adds the public-core Copilot code-review skill requested by automatically discovered ticket TS-161 and makes that skill trackable while continuing to ignore local skill overlays.

  • Adds valid code-review skill guidance covering repository context, architecture, pipeline readiness, model licensing, test evidence, and merge criteria.
  • Updates .gitignore to allow .github/skills/code-review/** while preserving the broader skills ignore rule.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
.github/skills/code-review/SKILL.md Adds the requested Trackdub-specific Copilot review skill with valid frontmatter and references to the repository’s existing review guidance.
.gitignore Narrows the skills ignore rule so the new code-review skill is committed while other local skill overlays remain ignored.

Reviews (3): Last reviewed commit: "Address Codex and Copilot review feedbac..." | Re-trigger Greptile

greptile-apps[bot]
greptile-apps Bot previously approved these changes Aug 8, 2026

Copilot AI left a comment

Copy link
Copy Markdown

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 GitHub Copilot code-review Agent Skill for the Trackdub public core and updates ignore rules so it’s committed/tracked while keeping other local skill overlays ignored.

Changes:

  • Update .gitignore to ignore .github/skills/* while explicitly un-ignoring .github/skills/code-review/**.
  • Add .github/skills/code-review/SKILL.md defining Copilot code-review guidance and pointers to REVIEW.md, AGENTS.md, and the PR template.

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.

File Description
.gitignore Adjusts ignore patterns to allow committing the code-review skill while keeping other skill overlays ignored.
.github/skills/code-review/SKILL.md Introduces the Copilot code-review agent skill content for Trackdub public-core review guidance.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .github/skills/code-review/SKILL.md Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0b8523baca

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/skills/code-review/SKILL.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
.github/skills/code-review/SKILL.md (1)

27-28: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Define a fallback when MCP tools are unavailable.

If the GitHub Copilot review environment does not expose the configured GitHub/Linear MCP tools, this mandatory step blocks TS-* reviews. Confirm tool availability. Otherwise, instruct reviewers to record missing issue context and continue using the supplied PR evidence.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/skills/code-review/SKILL.md around lines 27 - 28, Update the TS-*
issue review guidance to first confirm whether the configured GitHub/Linear MCP
tools are available. If unavailable, instruct reviewers to record that issue
context could not be loaded and continue evaluating scope and completeness using
the supplied PR evidence.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @.github/skills/code-review/SKILL.md:
- Around line 27-28: Update the TS-* issue review guidance to first confirm
whether the configured GitHub/Linear MCP tools are available. If unavailable,
instruct reviewers to record that issue context could not be loaded and continue
evaluating scope and completeness using the supplied PR evidence.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 26b29379-f9b5-4ad7-8d29-48dea9a6037c

📥 Commits

Reviewing files that changed from the base of the PR and between 83a7b76 and 0b8523b.

📒 Files selected for processing (2)
  • .github/skills/code-review/SKILL.md
  • .gitignore

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

1 issue found across 2 files

Confidence score: 5/5

  • In .github/skills/code-review/SKILL.md, the instruction to update THIRD_PARTY_NOTICES.md points to a non-existent root file, so automated reviewers may skip or misplace required notice updates and leave legal docs stale — update the guidance to docs/legal/THIRD_PARTY_NOTICES.md (or add a redirect note) to de-risk agent behavior.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name=".github/skills/code-review/SKILL.md">

<violation number="1" location=".github/skills/code-review/SKILL.md:79">
P3: This skill directs an automated reviewer to "Update THIRD_PARTY_NOTICES.md", but no such file exists at the repo root — the actual file is `docs/legal/THIRD_PARTY_NOTICES.md`. An agent following the instruction literally would look in the wrong place. Consider naming the full path to make the guidance actionable.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread .github/skills/code-review/SKILL.md Outdated
@kilo-code-bot

kilo-code-bot Bot commented Aug 8, 2026

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • .github/skills/code-review/SKILL.md - Previous issues addressed; no new issues found
Previous Review Summaries (2 snapshots, latest commit 44bfb3c)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 44bfb3c)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • .github/skills/code-review/SKILL.md - 1 changed line; path update to docs/legal/THIRD_PARTY_NOTICES.md is accurate

Previous review (commit 0b8523b)

Status: No New Issues Found | Recommendation: Existing comments should be addressed

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 0
Files Reviewed (2 files)
  • .github/skills/code-review/SKILL.md — new skill file (110 lines); 3 existing inline comments already flag issues on lines 28, 49, and 79
  • .gitignore — adjusted ignore patterns to un-ignore .github/skills/code-review/** while keeping other skill overlays ignored

Reviewed by step-3.7-flash · Input: 26.3K · Output: 3.1K · Cached: 149K

Review guidance: REVIEW.md from base branch main

Point reviewers at docs/legal/THIRD_PARTY_NOTICES.md so attribution checks match the repo layout.

Co-authored-by: Cursor <cursoragent@cursor.com>
@greptile-apps
greptile-apps Bot dismissed their stale review August 8, 2026 05:56

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

greptile-apps[bot]
greptile-apps Bot previously approved these changes Aug 8, 2026

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Auto-approved: Adds only a Markdown Copilot code-review skill and a matching .gitignore exception; no code, build, dependency, or runtime behavior changes appear in the diff. This is a docs/tooling-only change with no product, security, or operational tradeoff needing human review.

Re-trigger cubic

Approval not submitted

This repository is configured to approve as @tonythethompson, but that approval identity is unavailable.
GitHub does not allow a pull request author approval to count for their own PR.

cubic left this as a normal review comment instead of falling back to a Cubic App approval.

Preserve planner/router alias soft-hint exception from REVIEW.md, and add a fallback when Linear MCP is unavailable for TS-* context.

Co-authored-by: Cursor <cursoragent@cursor.com>
@greptile-apps
greptile-apps Bot dismissed their stale review August 8, 2026 06:20

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Auto-approved: Adds only a Copilot code-review skill Markdown file and a scoped .gitignore exception for it. No product code, runtime behavior, schema, or policy changes, so no human-owned tradeoff remains.

Re-trigger cubic

Approval not submitted

This repository is configured to approve as @tonythethompson, but that approval identity is unavailable.
GitHub does not allow a pull request author approval to count for their own PR.

cubic left this as a normal review comment instead of falling back to a Cubic App approval.

@tonythethompson
tonythethompson merged commit 8adb520 into main Aug 8, 2026
21 of 22 checks passed
@tonythethompson
tonythethompson deleted the agent/add-code-review-skill branch August 8, 2026 07:42
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.

2 participants