Skip to content

chore(all): Add a SKILL.md file for working with insta snapshots.#18957

Merged
Boshen merged 3 commits intomainfrom
skill-issue
Feb 10, 2026
Merged

chore(all): Add a SKILL.md file for working with insta snapshots.#18957
Boshen merged 3 commits intomainfrom
skill-issue

Conversation

@connorshea
Copy link
Member

@connorshea connorshea commented Feb 5, 2026

I find that AI Agent tools really like using insta incorrectly (e.g. #18953 (comment)), so this will hopefully give them some direction. See https://agentskills.io for more info.

This was generated with Claude Code, but then reviewed and revised a good amount by me.

I used .agents/skills/ as the directory, as it's supported by VS Code (soon), Codex, Cursor (soon), and a bunch of other tools (not Claude Code yet, I assume it'll be supported soon). The skill is only loaded into the context when the LLM thinks it's relevant, etc. etc. blah blah AI stuff.

I find that AI Agent tools really like using insta incorrectly, so let's give them some direction.

This was generated with Claude Code, but then reviewed and revised a good amount by me.
Copilot AI review requested due to automatic review settings February 5, 2026 01:41
@github-actions github-actions bot added the C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior label Feb 5, 2026
Copy link
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

This PR adds a comprehensive guide for working with insta snapshot tests in the Oxc codebase, specifically tailored for AI coding assistants that struggle with interactive terminal interfaces. The guide is placed in .agents/skills/ directory to be automatically loaded by various AI development tools.

Changes:

  • Added .agents/skills/insta-snapshots/SKILL.md containing detailed instructions for managing insta snapshots non-interactively
  • Provides clear workflows for running tests, reviewing snapshots, and accepting/rejecting changes without using the interactive cargo insta review command

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Connor Shea <connor.james.shea@gmail.com>
@connorshea connorshea requested a review from Boshen February 10, 2026 01:13
@Boshen Boshen merged commit 2f8eba7 into main Feb 10, 2026
19 checks passed
@Boshen Boshen deleted the skill-issue branch February 10, 2026 09:09
owjs3901 pushed a commit to owjs3901/oxc that referenced this pull request Feb 11, 2026
…c-project#18957)

I find that AI Agent tools really like using insta incorrectly (e.g.
oxc-project#18953 (comment)),
so this will hopefully give them some direction. See
https://agentskills.io for more info.

This was generated with Claude Code, but then reviewed and revised a
good amount by me.

I used `.agents/skills/` as the directory, as it's supported by VS Code
(soon), Codex, Cursor (soon), and a bunch of other tools (not Claude
Code yet, I assume it'll be supported soon). The skill is only loaded
into the context when the LLM thinks it's relevant, etc. etc. blah blah
AI stuff.

---------

Signed-off-by: Connor Shea <connor.james.shea@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants