Agent skill

Agentic Testing

by carlos-algms in carlos-algms/agentic.nvim

MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD.

MITAuto-check passedTesting & QA

Install Agentic Testing

skills CLI
$ npx skills add carlos-algms/agentic.nvim --skill agentic-testing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install carlos-algms/agentic.nvim agentic-testing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/carlos-algms/agentic.nvim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/agentic-testing .claude/skills/agentic-testing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agentic-testing
GitHub stars
639
Token cost
~828 tokens
SKILL.md length
401 words
Files
4 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD.

  • Works in 7 steps: Bootstrap missing symbols first so the… → Write the failing assertion. → Run the focused test with make test-file… → …
  • Tasks that involve Test-driven development
  • SKILL.md covers Framework, TDD, Commands and Before writing assertions, plus 1 more section
  • Calls make

What it does

Agentic Testing is an agent skill from carlos-algms/agentic.nvim. MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD. Covers mini.test workflow, red/green rules, commands, mark-count checks, and which test references to load.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/assert-spy.md`, `references/async-tests.md` and `references/child-nvim.md`).

It sits in Testing & QA, covering Test-driven development. It works with Lua. The repository describes itself as: Agentic Chat Interface directly in Neovim with ACP providers from Claude-Code, Gemini, Codex, OpenCode, and Cursor-agent. The licence is MIT.

When your agent uses it

  • Tasks that involve Test-driven development

Example prompts

  • “/agentic-testing”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Bootstrap missing symbols first so the test loads.
  2. Write the failing assertion.
  3. Run the focused test with make test-file FILE= and confirm it fails
  4. Implement the minimum code to pass.
  5. Re-run make test-file FILE=.
  6. Run the relevant full check.
  7. After adding or changing tests, reconcile the case count. This guards against

What it can do on your machine

Read from SKILL.md and the folder at commit e280dee. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agentic Testing loads about 828 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 401 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~828
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from carlos-algms/agentic.nvim at commit e280dee, republished under its MIT licence (© carlos-algms). 401 words, ~828 tokens.

Download SKILL.mdSave it as .claude/skills/agentic-testing/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
agentic-testing
description
MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD. Covers mini.test workflow, red/green rules, commands, mark-count checks, and which test references to load.

Agentic Testing

Framework

  • mini.test with Busted-style emulation.
  • Test files live next to source files as <module>.test.lua.
  • tests/ holds the runner, helpers, functional tests, and integration tests.
  • The previous Busted/lazy.nvim setup is gone.

TDD

For every bug fix or behavioral change:

  1. Bootstrap missing symbols first so the test loads.
  2. Write the failing assertion.
  3. Run the focused test with make test-file FILE=<path> and confirm it fails for behavior, not setup:
    1. wrong: missing module, nil method, syntax error, unresolved import
    2. right: value/state/output mismatch
  4. Implement the minimum code to pass.
  5. Re-run make test-file FILE=<path>.
  6. Run the relevant full check.
  7. After adding or changing tests, reconcile the case count. This guards against silently dropped OR unexpectedly generated tests. Both are failures.
    1. Compute EXPECTED cases by reading the file, not grepping:
      • each static it() = 1 case
      • each it() inside a for/each/table-driven loop = the loop's iteration count (a single it( line can emit many cases, or zero)
      • a grep of it( is a lower bound, never the answer
    2. Read ACTUAL from Total number of cases: N in the make test-file FILE=<path> output.
    3. EXPECTED MUST equal ACTUAL. Mismatch = a test was dropped, a loop is empty, or a generator misfired; stop and reconcile before claiming green. Eyeballing ACTUAL alone is NOT the check - you must derive EXPECTED first.

Pure refactors, formatting, and docs can skip red/green, but say that in the PR.

Show full SKILL.md (165 more words)Show less

Commands

bash
make test
bash
make test-file FILE=lua/agentic/acp/agent_modes.test.lua

Use make test-file FILE=<path> for the red/green inner loop; it runs one file in seconds. Never run make validate between iterations. After all .lua edits, run make validate and fix until it passes - the task is not done until it does. Pre-commit gate, not a per-test step.

For Lua or test changes, root AGENTS.md requires make validate after the focused checks.

Before writing assertions

Read the exact helper APIs before using them:

  • tests/helpers/assert.lua
  • tests/helpers/spy.lua
  • tests/helpers/child.lua when using child Neovim tests

Load references only when needed:

  • references/assert-spy.md: custom assert, spy, and stub API details.
  • references/child-nvim.md: child process tests and RPC helpers.
  • references/async-tests.md: scheduled/deferred code and mark-count traps.

Defaults

  • Unit tests: co-located <module>.test.lua.
  • Integration or functional tests: tests/integration/ or tests/functional/ when behavior spans modules or needs real editor state.
  • ACP or transport-touching tests must stub agentic.acp.acp_transport or any dependency that opens subprocesses or network calls.
  • Tests run sequentially in one Neovim process unless you explicitly use tests.helpers.child.
  • Clean up buffers, windows, autocommands, globals, stubs, and spies.

© carlos-algms, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/agentic-testing of carlos-algms/agentic.nvim.

  • SKILL.md
  • references/assert-spy.md
  • references/async-tests.md
  • references/child-nvim.md

Open the folder on GitHubat commit e280dee

Compare with similar skills

Agentic Testing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agentic Testing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agentic Testing this skillcarlos-algms/agentic.nvim639—~828Automated safety check: PassMIT
Jest Testing PatternsChrisWiles/claude-code-showcase6.1k7 repos~1.5kAutomated safety check: PassNone
Rust TDD Workflowrtk-ai/rtk83k—~753Automated safety check: NotesApache-2.0
TDDfossasia/eventyay-interpretation1.6k28 repos~1.1kAutomated safety check: PassApache-2.0
RTK Filter TDD in Rustrtk-ai/rtk83k—~1.9kAutomated safety check: NotesApache-2.0
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone

Similar skills

  • Jest Testing Patterns

    ChrisWiles/claude-code-showcase

    Jest patterns for React Native style tests: TDD discipline, mock factory functions, module and GraphQL hook mocking, custom render helpers and anti-patterns to avoid.

    6.1k GitHub starsUsed in 7 repos~1.5k tokens
    Testing & QAAuto-check passed
  • Enforces red-green-refactor for Rust work, with idiomatic test patterns, a naming convention and a pre-commit gate of cargo fmt, clippy and test.

    83k GitHub stars~753 tokensUpdated today
    Testing & QAAuto-check: notes
  • TDD

    fossasia/eventyay-interpretation

    Test-driven development. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 28 repos~1.1k tokens
    Testing & QAAuto-check passed
  • Enforces red-green-refactor for new RTK output filters in Rust, using real captured fixtures, snapshot tests with insta and token-savings assertions.

    83k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check: notes
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed

More from carlos-algms/agentic.nvim

All 8 skills in this repo
  • Agentic GitHub Discussion

    carlos-algms/agentic.nvim

    A skill your agent uses when creating, listing, or managing GitHub discussions in carlos-algms/agentic.nvim repository

    639 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agentic Acp Protocol Flow

    carlos-algms/agentic.nvim

    MANDATORY before editing ACPClient, ACPTransport, AgentInstance, ACP provider flow, tool-call parsing, permission requests, provider switch, reconnect, or ACP subprocess lifecycle in agentic.nvim.

    639 GitHub stars~636 tokensUpdated today
    Auto-check passed
  • Agentic Vimdoc

    carlos-algms/agentic.nvim

    A skill your agent uses when writing or updating agentic.nvim vimdoc (doc/agentic.txt), or after changing init.lua, configdefault.lua, theme.lua, or README install/keymaps - those edits require a…

    639 GitHub stars~298 tokensUpdated today
    Auto-check passed
  • Agentic Acp Docs And Schema

    carlos-algms/agentic.nvim

    A skill your agent uses when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation

    639 GitHub stars~468 tokensUpdated today
    Auto-check passed
  • Agentic Lua Class

    carlos-algms/agentic.nvim

    MANDATORY before writing or editing ANY .lua file in this repo - classes, methods, fields, functions, or LuaCATS annotations.

    639 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Agentic UI Message Writer

    carlos-algms/agentic.nvim

    MANDATORY before editing MessageWriter, PermissionManager, tool-call block rendering, sender headers, thinking blocks, auto-scroll, folds, status rows, permission buttons, or chat-buffer tool-call…

    639 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Agentic Testing

What does Agentic Testing do?

MANDATORY before creating, editing, or reviewing tests in agentic.nvim, and before behavior changes that require TDD. nvim.nvim, and before behavior changes that require TDD.

When should I use Agentic Testing?

Agentic Testing fits situations like: tasks that involve Test-driven development.

How do I install Agentic Testing in Claude Code?

Run `npx skills add carlos-algms/agentic.nvim --skill agentic-testing -a claude-code`. Or copy the skill folder (.agents/skills/agentic-testing in carlos-algms/agentic.nvim) into .claude/skills/agentic-testing in your project. Claude Code loads it when a task matches its description.

How do I install Agentic Testing in Codex?

Run `npx skills add carlos-algms/agentic.nvim --skill agentic-testing -a codex`. Or copy the skill folder (.agents/skills/agentic-testing in carlos-algms/agentic.nvim) into .agents/skills/agentic-testing in your project. Codex loads it when a task matches its description.

Can I use Agentic Testing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add carlos-algms/agentic.nvim --skill agentic-testing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agentic-testing, .gemini/skills/agentic-testing, .github/skills/agentic-testing and .opencode/skills/agentic-testing in your project.

What does Agentic Testing need to run?

Going by SKILL.md and its folder, Agentic Testing needs the command-line tools its instructions call (make).

Does Agentic Testing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agentic Testing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Agentic Testing use?

Agentic Testing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agentic Testing use?

About 828 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Agentic Testing?

Skills that share tags, products or a category with Agentic Testing: Jest Testing Patterns (ChrisWiles/claude-code-showcase, 6.1k stars), Rust TDD Workflow (rtk-ai/rtk, 83k stars), TDD (fossasia/eventyay-interpretation, 1.6k stars) and RTK Filter TDD in Rust (rtk-ai/rtk, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentic Testing?

carlos-algms (a GitHub user) maintains it in carlos-algms/agentic.nvim, which has 639 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 7, 2026.

Source: carlos-algms/agentic.nvim on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.