Agent skill

Provider Tests

by yqlay in yqlay/flclash-tui

A skill your agent uses when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

GPL-3.0Auto-check passedFrontend & Design

Install Provider Tests

skills CLI
$ npx skills add yqlay/flclash-tui --skill provider-tests -a claude-code

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

GitHub CLI
$ gh skill install yqlay/flclash-tui provider-tests --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/yqlay/flclash-tui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/provider-tests .claude/skills/provider-tests && 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
provider-tests
GitHub stars
119
Token cost
~363 tokens
SKILL.md length
160 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
GPL-3.0

At a glance

A skill your agent uses when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

  • Works in 7 steps: Read the provider under test and its… → Use ProviderContainer directly when no… → Dispose containers in teardown or with… → …
  • Updating FlClash Riverpod provider tests
  • SKILL.md covers When To Use, Workflow and Pitfalls
  • Calls flutter and dart

What it does

Provider Tests is an agent skill from yqlay/flclash-tui. Use when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering State management. The repository describes itself as: Linux/SSH/headless Mihomo TUI. Default silent: only flc COMMAND uses the proxy. The licence is GPL-3.0.

When your agent uses it

  • Updating FlClash Riverpod provider tests
  • State-management tests in this repository

Example prompts

  • “/provider-tests”

Workflow steps

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

  1. Read the provider under test and its generated public API before writing assertions.
  2. Use ProviderContainer directly when no widget tree is needed.
  3. Dispose containers in teardown or with addTearDown(container.dispose).
  4. Prefer generated notifier APIs over implementation details. Generated update() takes a callback
  5. Mock external dependencies with mocktail; register fallback values for freezed params used with any().
  6. Keep tests focused on behavior: defaults, state transitions, persistence boundaries, and side effects.
  7. Run the narrowest relevant test first

What it can do on your machine

Read from SKILL.md and the folder at commit 89df3cf. 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:

    • flutter
    • dart

    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

Provider Tests loads about 363 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 160 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~363

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 yqlay/flclash-tui at commit 89df3cf, republished under its GPL-3.0 licence (© yqlay). 160 words, ~363 tokens.

Download SKILL.mdSave it as .claude/skills/provider-tests/SKILL.md (or your agent's skills folder).
name
provider-tests
description
Use when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

Provider Tests

When To Use

Use this for tests under test/providers/ or any change that validates Riverpod providers, generated notifiers, app state defaults, or provider interactions.

For broader test expansion, pair this with .agents/rules.md and .agents/commands.md.

Workflow

  1. Read the provider under test and its generated public API before writing assertions.

  2. Use ProviderContainer directly when no widget tree is needed.

  3. Dispose containers in teardown or with addTearDown(container.dispose).

  4. Prefer generated notifier APIs over implementation details. Generated update() takes a callback:

    dart
    notifier.update((state) => newValue);
  5. Mock external dependencies with mocktail; register fallback values for freezed params used with any().

  6. Keep tests focused on behavior: defaults, state transitions, persistence boundaries, and side effects.

  7. Run the narrowest relevant test first:

    bash
    flutter test test/providers/

Pitfalls

  • Do not use dart test; FlClash models and provider tests may depend on Flutter types.
  • Re-check source defaults before asserting them; provider defaults can drift.
  • If async provider timing matters, wait on provider futures or state changes instead of fixed sleeps.

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

Files

Just SKILL.md in .agents/skills/provider-tests of yqlay/flclash-tui.

Open the folder on GitHubat commit 89df3cf

Compare with similar skills

Provider Tests 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.

Provider Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Provider Tests this skillyqlay/flclash-tui119—~363Automated safety check: PassGPL-3.0
Svelte Core Best Practicesrilldata/rill2.9k4 repos~1.8kAutomated safety check: PassApache-2.0
Dify Component Writing Guidelanggenius/dify158k—~626Automated safety check: PassCustom licence
React State Managementinvolvex/youtube-music-cli45613 repos~3kAutomated safety check: PassMIT
GPUI Kit Desktop App GuideAprilNEA/OpenLogi23k—~5.5kAutomated safety check: PassApache-2.0
Pierre Theming Librarypierrecomputer/pierre6.2k—~661Automated safety check: PassApache-2.0

Similar skills

  • Rules for writing idiomatic Svelte 5 code: when to reach for runes like state, derived and effect, and how to handle props, attachments and bindings.

    2.9k GitHub starsUsed in 4 repos~1.8k tokens
    Frontend & DesignAuto-check passed
  • Use when implementing or refactoring React/TypeScript components and the task requires decisions about component ownership, feature boundaries, state, data…

    158k GitHub stars~626 tokensUpdated today
    Frontend & DesignAuto-check passed
  • React State Management

    involvex/youtube-music-cli

    Master modern React state management with Redux Toolkit, Zustand, Jotai, and React Query.

    456 GitHub starsUsed in 13 repos~3k tokens
    Frontend & DesignAuto-check passed
  • Guides building Rust desktop apps with the gpui-kit crate, covering component selection, state ownership, theming and overlays, plus normative GPUI coding rules.

    23k GitHub stars~5.5k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Pierre Theming Library

    pierrecomputer/pierre

    Explains how to use the @pierre/theming package to list, resolve, select, switch and persist themes, with controller, color and React references.

    6.2k GitHub stars~661 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Frontend Patterns

    kurealnum/dotfiles

    Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.

    290 GitHub starsUsed in 19 repos~3.7k tokens
    Frontend & DesignAuto-check passed

More from yqlay/flclash-tui

  • Localization

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash UI text, scanning for hardcoded Chinese strings, updating ARB localization, or fixing generated locale output in this repository.

    119 GitHub stars~440 tokensUpdated 3 days ago
    Auto-check passed
  • UI Work

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash Flutter UI, widgets, screens, Material You styling, navigation surfaces, or user-facing interactions.

    119 GitHub stars~302 tokensUpdated 3 days ago
    Auto-check passed
  • Ssh Tui UX

    yqlay/flclash-tui

    A skill your agent uses when changing Linux TUI/CLI SSH Capture copy, empty states, picker labels, SSH dashboard hints, or the Connect vs Capture vs ssh -D vs ssh -R user flow.

    119 GitHub stars~815 tokensUpdated 3 days ago
    Auto-check passed
  • Core Platform

    yqlay/flclash-tui

    A skill your agent uses when changing FlClash core integration, platform managers, Go core communication, desktop/mobile platform behavior, or Windows helper flow.

    119 GitHub stars~376 tokensUpdated 3 days ago
    Auto-check passed

Questions about Provider Tests

What does Provider Tests do?

A skill your agent uses when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository. Provider Tests is an agent skill from yqlay/flclash-tui. Use when adding or updating FlClash Riverpod provider tests, notifier tests, or state-management tests in this repository.

When should I use Provider Tests?

Provider Tests fits situations like: updating FlClash Riverpod provider tests; state-management tests in this repository.

How do I install Provider Tests in Claude Code?

Run `npx skills add yqlay/flclash-tui --skill provider-tests -a claude-code`. Or copy the skill folder (.agents/skills/provider-tests in yqlay/flclash-tui) into .claude/skills/provider-tests in your project. Claude Code loads it when a task matches its description.

How do I install Provider Tests in Codex?

Run `npx skills add yqlay/flclash-tui --skill provider-tests -a codex`. Or copy the skill folder (.agents/skills/provider-tests in yqlay/flclash-tui) into .agents/skills/provider-tests in your project. Codex loads it when a task matches its description.

Can I use Provider Tests 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 yqlay/flclash-tui --skill provider-tests -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/provider-tests, .gemini/skills/provider-tests, .github/skills/provider-tests and .opencode/skills/provider-tests in your project.

What does Provider Tests need to run?

Going by SKILL.md and its folder, Provider Tests needs the command-line tools its instructions call (flutter and dart).

Does Provider Tests 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 Provider Tests 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 Provider Tests use?

Provider Tests is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Provider Tests use?

About 363 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Provider Tests?

Skills that share tags, products or a category with Provider Tests: Svelte Core Best Practices (rilldata/rill, 2.9k stars), Dify Component Writing Guide (langgenius/dify, 158k stars), React State Management (involvex/youtube-music-cli, 456 stars) and GPUI Kit Desktop App Guide (AprilNEA/OpenLogi, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Provider Tests?

yqlay (a GitHub user) maintains it in yqlay/flclash-tui, which has 119 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 5, 2026.

Source: yqlay/flclash-tui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.