Agent skill

Client Compatibility

by FritzAndFriends in FritzAndFriends/SharpSite

Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces

MITAuto-check passed

Install Client Compatibility

skills CLI
$ npx skills add FritzAndFriends/SharpSite --skill client-compatibility -a claude-code

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

GitHub CLI
$ gh skill install FritzAndFriends/SharpSite client-compatibility --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/FritzAndFriends/SharpSite.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.copilot/skills/client-compatibility .claude/skills/client-compatibility && 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
client-compatibility
GitHub stars
145
Used in
2 other repos
Token cost
~1.3k tokens
SKILL.md length
587 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces

  • Works in 3 steps: CLI mode — task tool is available → full… → VS Code mode — runSubagent or agent tool… → Fallback mode — neither task nor…
  • SKILL.md covers Context, Patterns, Examples and Anti-Patterns
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Client Compatibility is an agent skill from FritzAndFriends/SharpSite. Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces

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

It works with Visual Studio Code. The repository describes itself as: A basic CMS built with .NET 9 and Blazor. The licence is MIT.

Example prompts

  • “/client-compatibility”

Workflow steps

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

  1. CLI mode — task tool is available → full spawning control. Use task with agent_type, mode, model, description, prompt parameters. Collect…
  2. VS Code mode — runSubagent or agent tool is available → conditional behavior. Use runSubagent with the task prompt. Drop agent_type, mode…
  3. Fallback mode — neither task nor runSubagent/agent available → work inline. Do not apologize or explain the limitation. Execute the task…

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    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

Client Compatibility loads about 1.3k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 587 words of instructions outside code blocks.

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

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 FritzAndFriends/SharpSite at commit c35e5e0, republished under its MIT licence (© FritzAndFriends). 587 words, ~1,335 tokens.

Download SKILL.mdSave it as .claude/skills/client-compatibility/SKILL.md (or your agent's skills folder).
name
client-compatibility
description
Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces
domain
orchestration
confidence
high
source
extracted

Context

Squad runs on multiple Copilot surfaces (CLI, VS Code, JetBrains, GitHub.com). The coordinator must detect its platform and adapt spawning behavior accordingly. Different tools are available on different platforms, requiring conditional logic for agent spawning, SQL usage, and response timing.

Patterns

Platform Detection

Before spawning agents, determine the platform by checking available tools:

  1. CLI mode — task tool is available → full spawning control. Use task with agent_type, mode, model, description, prompt parameters. Collect results via read_agent.

  2. VS Code mode — runSubagent or agent tool is available → conditional behavior. Use runSubagent with the task prompt. Drop agent_type, mode, and model parameters. Multiple subagents in one turn run concurrently (equivalent to background mode). Results return automatically — no read_agent needed.

  3. Fallback mode — neither task nor runSubagent/agent available → work inline. Do not apologize or explain the limitation. Execute the task directly.

If both task and runSubagent are available, prefer task (richer parameter surface).

VS Code Spawn Adaptations

When in VS Code mode, the coordinator changes behavior in these ways:

  • Spawning tool: Use runSubagent instead of task. The prompt is the only required parameter — pass the full agent prompt (charter, identity, task, hygiene, response order) exactly as you would on CLI.
  • Parallelism: Spawn ALL concurrent agents in a SINGLE turn. They run in parallel automatically. This replaces mode: "background" + read_agent polling.
  • Model selection: Accept the session model. Do NOT attempt per-spawn model selection or fallback chains — they only work on CLI. In Phase 1, all subagents use whatever model the user selected in VS Code's model picker.
  • Scribe: Cannot fire-and-forget. Batch Scribe as the LAST subagent in any parallel group. Scribe is light work (file ops only), so the blocking is tolerable.
  • Launch table: Skip it. Results arrive with the response, not separately. By the time the coordinator speaks, the work is already done.
  • read_agent: Skip entirely. Results return automatically when subagents complete.
  • agent_type: Drop it. All VS Code subagents have full tool access by default. Subagents inherit the parent's tools.
  • description: Drop it. The agent name is already in the prompt.
  • Prompt content: Keep ALL prompt structure — charter, identity, task, hygiene, response order blocks are surface-independent.
Show full SKILL.md (233 more words)Show less
Feature Degradation Table
FeatureCLIVS CodeDegradation
Parallel fan-outmode: "background" + read_agentMultiple subagents in one turnNone — equivalent concurrency
Model selectionPer-spawn model param (4-layer hierarchy)Session model only (Phase 1)Accept session model, log intent
Scribe fire-and-forgetBackground, never readSync, must waitBatch with last parallel group
Launch table UXShow table → results laterSkip table → results with responseUX only — results are correct
SQL toolAvailableNot availableAvoid SQL in cross-platform code paths
Response order bugCritical workaroundPossibly necessary (unverified)Keep the block — harmless if unnecessary
SQL Tool Caveat

The sql tool is CLI-only. It does not exist on VS Code, JetBrains, or GitHub.com. Any coordinator logic or agent workflow that depends on SQL (todo tracking, batch processing, session state) will silently fail on non-CLI surfaces. Cross-platform code paths must not depend on SQL. Use filesystem-based state (.squad/ files) for anything that must work everywhere.

Examples

Example 1: CLI parallel spawn

typescript
// Coordinator detects task tool available → CLI mode
task({ agent_type: "general-purpose", mode: "background", model: "claude-sonnet-4.5", ... })
task({ agent_type: "general-purpose", mode: "background", model: "claude-haiku-4.5", ... })
// Later: read_agent for both

Example 2: VS Code parallel spawn

typescript
// Coordinator detects runSubagent available → VS Code mode
runSubagent({ prompt: "...Fenster charter + task..." })
runSubagent({ prompt: "...Hockney charter + task..." })
runSubagent({ prompt: "...Scribe charter + task..." }) // Last in group
// Results return automatically, no read_agent

Example 3: Fallback mode

typescript
// Neither task nor runSubagent available → work inline
// Coordinator executes the task directly without spawning

Anti-Patterns

  • ❌ Using SQL tool in cross-platform workflows (breaks on VS Code/JetBrains/GitHub.com)
  • ❌ Attempting per-spawn model selection on VS Code (Phase 1 — only session model works)
  • ❌ Fire-and-forget Scribe on VS Code (must batch as last subagent)
  • ❌ Showing launch table on VS Code (results already inline)
  • ❌ Apologizing or explaining platform limitations to the user
  • ❌ Using task when only runSubagent is available
  • ❌ Dropping prompt structure (charter/identity/task) on non-CLI platforms

© FritzAndFriends, MIT. 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 .copilot/skills/client-compatibility of FritzAndFriends/SharpSite.

Open the folder on GitHubat commit c35e5e0

Used in 2 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in FritzAndFriends/SharpSite, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Client Compatibility 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.

Client Compatibility compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Client Compatibility this skillFritzAndFriends/SharpSite1452 repos~1.3kAutomated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Electron App Automationvercel-labs/agent-browser44k5 repos~1.7kAutomated safety check: PassApache-2.0
Microsoft Skill CreatorMicrosoftDocs/mcp1.9k3 repos~2.1kAutomated safety check: PassCC-BY-4.0
Evals Contextzgsm-ai/costrict4.4k1 repos~1.9kAutomated safety check: PassApache-2.0
Ketch1broseidon/ketch6971 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Electron App Automation

    vercel-labs/agent-browser

    Official

    Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.

    44k GitHub starsUsed in 5 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Microsoft Skill Creator

    MicrosoftDocs/mcp

    Official

    Create agent skills for Microsoft technologies using official documentation.

    1.9k GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Evals Context

    zgsm-ai/costrict

    Provides context about the CoStrict evals system structure in this monorepo.

    4.4k GitHub starsUsed in 1 repo~1.9k tokens
    AI & LLM EngineeringAuto-check passed
  • Ketch

    1broseidon/ketch

    Research skill for ketch — a fast stateless CLI for web search, OSS code search, curated library docs, page scraping, and site crawling; an optional MCP server exists for operators who want it, but…

    697 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • Lore

    specstoryai/getspecstory

    SpecStory Lore - mine your SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more) into a persistent corpus, surface your reproducible workflows with corroborated…

    1.3k GitHub starsUsed in 1 repo~8.4k tokens
    Auto-check: notes

More from FritzAndFriends/SharpSite

All 18 skills in this repo
  • Architectural Proposals

    FritzAndFriends/SharpSite

    How to write comprehensive architectural proposals that drive alignment before code is written

    145 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed
  • Distributed Mesh

    FritzAndFriends/SharpSite

    How to coordinate with squads on different machines using git as transport

    145 GitHub starsUsed in 2 repos~3.1k tokens
    Auto-check passed
  • Docs Standards

    FritzAndFriends/SharpSite

    Microsoft Style Guide + Squad-specific documentation patterns

    145 GitHub starsUsed in 2 repos~567 tokens
    Auto-check passed
  • Economy Mode

    FritzAndFriends/SharpSite

    Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.

    145 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • External Comms

    FritzAndFriends/SharpSite

    PAO workflow for scanning, drafting, and presenting community responses with human review gate

    145 GitHub starsUsed in 2 repos~3.1k tokens
    Auto-check passed
  • Gh Auth Isolation

    FritzAndFriends/SharpSite

    Safely manage multiple GitHub identities (EMU + personal) in agent workflows

    145 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check: notes

Questions about Client Compatibility

What does Client Compatibility do?

Platform detection and adaptive spawning for CLI vs VS Code vs other surfaces. Client Compatibility is an agent skill from FritzAndFriends/SharpSite.

How do I install Client Compatibility in Claude Code?

Run `npx skills add FritzAndFriends/SharpSite --skill client-compatibility -a claude-code`. Or copy the skill folder (.copilot/skills/client-compatibility in FritzAndFriends/SharpSite) into .claude/skills/client-compatibility in your project. Claude Code loads it when a task matches its description.

How do I install Client Compatibility in Codex?

Run `npx skills add FritzAndFriends/SharpSite --skill client-compatibility -a codex`. Or copy the skill folder (.copilot/skills/client-compatibility in FritzAndFriends/SharpSite) into .agents/skills/client-compatibility in your project. Codex loads it when a task matches its description.

Can I use Client Compatibility 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 FritzAndFriends/SharpSite --skill client-compatibility -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/client-compatibility, .gemini/skills/client-compatibility, .github/skills/client-compatibility and .opencode/skills/client-compatibility in your project.

What does Client Compatibility need to run?

SKILL.md names no scripts, command-line tools or credentials: Client Compatibility is instructions for the agent only.

Does Client Compatibility 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 Client Compatibility 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 Client Compatibility use?

Client Compatibility 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 Client Compatibility use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 Client Compatibility?

Skills that share tags, products or a category with Client Compatibility: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Electron App Automation (vercel-labs/agent-browser, 44k stars), Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars) and Evals Context (zgsm-ai/costrict, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Client Compatibility?

FritzAndFriends (a GitHub organization) maintains it in FritzAndFriends/SharpSite, which has 145 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on April 30, 2026.

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