Skip to content

chore(ci): update skills - #214

Open
coryrylan wants to merge 1 commit into
mainfrom
topic-skill-fixes
Open

chore(ci): update skills#214
coryrylan wants to merge 1 commit into
mainfrom
topic-skill-fixes

Conversation

@coryrylan

@coryrylan coryrylan commented Aug 12, 2026

Copy link
Copy Markdown
Collaborator
  • fix missing skill details
  • align pre commit hooks to pnpm scripts
  • fix agent cloud env var
  • add project authoring skill for standing up new projects

Summary by CodeRabbit

  • New Features

    • Added a guided workflow for scaffolding standalone component projects, including integration, verification, dry-run, and safe rollback support.
  • Bug Fixes

    • Improved environment isolation and pre-commit handling for Git LFS changes.
    • Clarified staged-file linting so test files are excluded appropriately.
  • Documentation

    • Expanded guidance for project upkeep, builds, linting, accessibility, SSR checks, and release verification.
  • Chores

    • Refreshed bundled dependency notices and attribution details.

@coryrylan coryrylan self-assigned this Aug 12, 2026
@github-actions github-actions Bot added scope(ci) scope(internals) scope(cli) dependencies Pull requests that update a dependency file labels Aug 12, 2026
@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 9699a16b-db07-4909-aad7-85248db90e9a

📥 Commits

Reviewing files that changed from the base of the PR and between 5e25555 and 87c0817.

📒 Files selected for processing (4)
  • .agents/skills/agent-upkeep/SKILL.md
  • .agents/skills/authoring-projects/SKILL.md
  • package.json
  • projects/internals/BUILD.md
 __________________________________________________________________________________________
< Recursion is the root of computation since it trades description for time. - Alan Perlis >
 ------------------------------------------------------------------------------------------
  \
   \   (\__/)
       (•ㅅ•)
       /   づ
📝 Walkthrough

Walkthrough

Changes

The changes add a component project scaffolding CLI and integration checklist. They also update upkeep, build, lint, pre-commit, agent isolation, Git LFS, and dependency notice guidance.

Repository tooling and guidance

Layer / File(s) Summary
Project scaffolding workflow
.agents/skills/authoring-projects/SKILL.md, .agents/skills/authoring-projects/references/integration-checklist.md
Defines the scaffold-first workflow, integration requirements, verification commands, and release safeguards for standalone component projects.
Scaffold input and project generation
.agents/skills/authoring-projects/scripts/scaffold-project.mjs
Adds option parsing, repository validation, tracked reference-project copying, metadata normalization, and generated content preparation.
Scaffold repository integration
.agents/skills/authoring-projects/scripts/scaffold-project.mjs
Updates workspace, CI, site, metadata, lint, Lighthouse, and Knip configuration. The CLI supports dry-run planning and transactional file application.
Upkeep and validation guidance
.agents/skills/agent-upkeep/SKILL.md, .agents/skills/authoring-documentation/SKILL.md, .agents/skills/guidance-build-system/SKILL.md, projects/internals/BUILD.md
Updates verification requirements, bug-task handling, pull request checks, Vale exclusions, Wireit cleanup, and Git LFS review guidance.
Hook and lint behavior
.agents/hooks/pre-tool-use-bash.sh, .husky/pre-commit, package.json
Sets isolated agent mode for cursor, handles Git LFS changes without stashing, and excludes test files from Vale linting.
Dependency notice updates
NOTICE.md, projects/cli/NOTICE.md
Updates bundled versions and matching MIT attribution entries for @inquirer/prompts, marked, and ora.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Author
  participant ScaffoldCLI
  participant Repository
  participant NewProject
  Author->>ScaffoldCLI: provide project name, reference, and description
  ScaffoldCLI->>Repository: read tracked reference files and integration targets
  ScaffoldCLI->>NewProject: create normalized project files
  ScaffoldCLI->>Repository: update workspace, CI, site, metadata, lint, and Knip configuration
  ScaffoldCLI-->>Author: report planned or applied changes
Loading
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main changes to skills and CI-related guidance.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch topic-skill-fixes

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

@coderabbitai coderabbitai 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.

Actionable comments posted: 6

🤖 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.

Inline comments:
In @.agents/skills/agent-upkeep/SKILL.md:
- Line 141: Update the verification guidance around the “Done when” criterion
and the commands in the verification section to consistently cover all
applicable project scripts, including optional test:lighthouse and test:visual
invocations, or narrow the completion criterion to only the listed commands.
Ensure users cannot satisfy the procedure while omitting suites that the
repository guidance identifies as applicable.

In @.agents/skills/authoring-documentation/SKILL.md:
- Line 31: Update the Pre-commit bullet in the documentation to insert a space
after the colon, so the text reads “lint-staged): automatically” while
preserving the rest of the wording.

In @.agents/skills/authoring-projects/scripts/scaffold-project.mjs:
- Around line 20-22: Update the description validation in scaffold-project’s
argument-validation flow to reject values containing the JSDoc terminator
sequence */ before file planning or generation. Preserve the existing
single-line check and fail through the established fail validation path with a
clear --description error.
- Around line 392-406: Update the catch block in applyChanges to remove every
path from changesToApply that is absent from originals, while retaining
restoration of existing files and projectDirectory cleanup. Add a regression
test that forces a write failure after the documentation page is created and
verifies the newly created page is removed.

In @.agents/skills/authoring-projects/SKILL.md:
- Around line 41-48: The verification checklist in
.agents/skills/authoring-projects/SKILL.md lines 41-48 must include the metadata
generation command alongside the existing project checks. Update the next-step
output in .agents/skills/authoring-projects/scripts/scaffold-project.mjs lines
65-68 to instruct users to run metadata generation before final verification.
- Line 50: Update the CI guidance in the numbered workflow step so it explicitly
distinguishes changes requiring broader CI from changes covered by project-local
checks: require broader CI for changes affecting shared infrastructure, build or
release configuration, cross-project interfaces, generated artifacts, or
multiple packages, while allowing targeted project checks for isolated changes.
Preserve the existing final-diff inspection requirements and follow the
repository’s technical writing style.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: b1a785a0-94a7-406c-ac04-579cb464f94d

📥 Commits

Reviewing files that changed from the base of the PR and between 58a64b2 and 2c90408.

📒 Files selected for processing (12)
  • .agents/hooks/pre-tool-use-bash.sh
  • .agents/skills/agent-upkeep/SKILL.md
  • .agents/skills/authoring-documentation/SKILL.md
  • .agents/skills/authoring-projects/SKILL.md
  • .agents/skills/authoring-projects/references/integration-checklist.md
  • .agents/skills/authoring-projects/scripts/scaffold-project.mjs
  • .agents/skills/guidance-build-system/SKILL.md
  • .husky/pre-commit
  • NOTICE.md
  • package.json
  • projects/cli/NOTICE.md
  • projects/internals/BUILD.md

Comment thread .agents/skills/agent-upkeep/SKILL.md
Comment thread .agents/skills/authoring-documentation/SKILL.md Outdated
Comment thread .agents/skills/authoring-projects/scripts/scaffold-project.mjs
Comment thread .agents/skills/authoring-projects/scripts/scaffold-project.mjs
Comment thread .agents/skills/authoring-projects/SKILL.md
Comment thread .agents/skills/authoring-projects/SKILL.md Outdated

@coderabbitai coderabbitai 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.

Actionable comments posted: 2

🤖 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.

Inline comments:
In @.agents/skills/agent-upkeep/SKILL.md:
- Around line 170-191: Update the Verification section in SKILL.md to enforce
complete CI: run the repository-root `mise exec -- pnpm run ci`, or document an
equivalent command set covering all root and project checks. For Mode A, ensure
the verification commands run from every selector-provided
`packages[].workingDirectory`, not only one project, while preserving the
instruction to record absent scripts and stop on visual-test failures.

In @.agents/skills/authoring-projects/scripts/scaffold-project.mjs:
- Around line 22-23: Update the --description validation near the existing
newline checks in scaffold-project.mjs to reject carriage returns as well as LF
characters, preserving the single-line contract before the description is
written into the generated JSDoc.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 45a324d4-24f4-4c66-a517-db08956f7c56

📥 Commits

Reviewing files that changed from the base of the PR and between 2c90408 and 5e25555.

📒 Files selected for processing (4)
  • .agents/skills/agent-upkeep/SKILL.md
  • .agents/skills/authoring-documentation/SKILL.md
  • .agents/skills/authoring-projects/SKILL.md
  • .agents/skills/authoring-projects/scripts/scaffold-project.mjs

Comment thread .agents/skills/agent-upkeep/SKILL.md
Comment on lines +22 to +23
if (description.includes('\n')) fail('--description must be a single line.');
if (description.includes('*/')) fail('--description must not contain "*/".');

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Reject carriage returns in --description.

Line 22 rejects only LF. A value with a standalone \r passes validation and creates an additional physical line when Line 172 writes the JSDoc. This can alter generated JSDoc tags and violates the single-line description contract.

Proposed fix
-if (description.includes('\n')) fail('--description must be a single line.');
+if (/[\r\n]/u.test(description)) fail('--description must be a single line.');
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
if (description.includes('\n')) fail('--description must be a single line.');
if (description.includes('*/')) fail('--description must not contain "*/".');
if (/[\r\n]/u.test(description)) fail('--description must be a single line.');
if (description.includes('*/')) fail('--description must not contain "*/".');
🤖 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 @.agents/skills/authoring-projects/scripts/scaffold-project.mjs around lines
22 - 23, Update the --description validation near the existing newline checks in
scaffold-project.mjs to reject carriage returns as well as LF characters,
preserving the single-line contract before the description is written into the
generated JSDoc.

Comment thread .agents/skills/authoring-projects/SKILL.md Outdated
Comment thread .agents/skills/authoring-projects/SKILL.md Outdated
Comment thread .agents/skills/authoring-projects/SKILL.md Outdated
Comment thread .agents/skills/authoring-projects/SKILL.md Outdated
@coryrylan
coryrylan force-pushed the topic-skill-fixes branch 4 times, most recently from 537421d to 6d4214e Compare August 13, 2026 13:14
- fix missing skill details
- align pre commit hooks to pnpm scripts
- fix agent cloud env var
- add project authoring skill for standing up new projects

Signed-off-by: Cory Rylan <crylan@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file scope(ci) scope(cli) scope(internals)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants