Skip to content

docs: Add agent skills#1040

Open
RandomByte wants to merge 2 commits into
mainfrom
docs/add-agent-skills
Open

docs: Add agent skills#1040
RandomByte wants to merge 2 commits into
mainfrom
docs/add-agent-skills

Conversation

@RandomByte

Copy link
Copy Markdown
Member

No description provided.

@stopcoder

stopcoder commented Apr 29, 2026

Copy link
Copy Markdown
Member

I validated the create-rule skill with a change created by the agent and one inconsistency between the existing tests and the skill is found:

Also note the skill recommends using runLintRulesTests(import.meta.url) directly in the test file, but the actual function signature requires a string path, and all existing tests use fileURLToPath(import.meta.url) first — so our implementation correctly follows the existing codebase convention over the skill's example.

@RandomByte RandomByte force-pushed the docs/add-agent-skills branch from 583725a to 6ff9a7b Compare June 8, 2026 12:33
@RandomByte RandomByte requested a review from a team June 8, 2026 12:36

@d3xter666 d3xter666 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

Just one small remark:
Symlinks for .claude/skills might not work in some environments.

For the agents plugin we simply copy the skills during the build phase

@d3xter666 d3xter666 requested a review from a team June 9, 2026 07:14
@RandomByte

Copy link
Copy Markdown
Member Author

Just one small remark: Symlinks for .claude/skills might not work in some environments.

For the agents plugin we simply copy the skills during the build phase

I saw this practice in other projects, e.g. https://github.com/NVIDIA/OpenShell/blob/main/.claude/skills

Also https://github.com/vercel-labs/skills#installation-methods seems to work with symlinks by default. Let me know if you face any issues with one of your tools!

Comment on lines +242 to +243
- `FirstChild` - When replacing `Config.getTheme()` with `Theming.getTheme()` (same args)
- `SecondChild` - When replacing `Config.setRTL(val)` with `Localization.setRTL(val)` and the Config access needs to be replaced but the method name stays

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't really see a difference between the two examples here. Maybe the examples can be updated to better show how they differ?

**Run the autofix tests:**

```bash
npm run unit -- test/lib/autofix/autofix.projects.ts

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think this should be test/lib/autofix/autofix.fixtures.ts.

autofix.projects.ts runs the fixture projects from fixtures/linter/projects, not fixtures/autofix.

**Update snapshots:**

```bash
npm run unit-update-snapshots -- test/lib/autofix/autofix.projects.ts

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Same here, and in the snapshots below.

Comment on lines +161 to +169
test/fixtures/linter/rules/$0/
Positive_1/ # Code that SHOULD trigger the rule
webapp/
Component.js # (or whatever files are relevant)
manifest.json # (include if needed by the check)
Negative_1/ # Code that should NOT trigger the rule
webapp/
Component.js
manifest.json

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The dir-based testing based on projects currently only works for AsyncComponentFlags and renderer (see if-clause in test/lib/linter/_linterHelper.ts#createTestsForFixtures).

In all other cases, the code will lint each file one by one (isolated).

Comment thread AGENTS.md
@@ -0,0 +1,146 @@
# CLAUDE.md

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

AGENTS.md?

Comment thread AGENTS.md
- `docs/Scope-of-Autofix.md` - Lists APIs that cannot be replaced automatically and why
- `docs/Development.md` - Development guidelines and autofix implementation checklist

## Autofix Development

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Refer to the skill here? But as skills are "visible" to agents anyways, maybe this can be completely removed.

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