Agent skill

Tech Divergence

by WellApp-ai in WellApp-ai/Well

Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

MITAuto-check passedAgent Workflows

Install Tech Divergence

skills CLI
$ npx skills add WellApp-ai/Well --skill tech-divergence -a claude-code

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

GitHub CLI
$ gh skill install WellApp-ai/Well tech-divergence --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/WellApp-ai/Well.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cursor-rules/skills/tech-divergence .claude/skills/tech-divergence && 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
tech-divergence
GitHub stars
345
Token cost
~1.3k tokens
SKILL.md length
379 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

  • Works in 4 steps: Gather Context → Score Each Dimension → Determine Path → …
  • Gate 4 for significant decisions
  • SKILL.md covers When to Use, Scoring Matrix (8 Dimensions), Phase 1: Gather Context and Phase 2: Score Each Dimension, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tech Divergence is an agent skill from WellApp-ai/Well. Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

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 sits in Agent Workflows. The repository describes itself as: No more Sundays on Finance. We build the infrastructure that retrieves, processes, and routes your financial and business data to your FinOps stack, so founders can ship, not… The licence is MIT.

When your agent uses it

  • Gate 4 for significant decisions

Example prompts

  • “/tech-divergence”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Gather Context
  2. Score Each Dimension
  3. Determine Path
  4. Record Decision

What it can do on your machine

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

    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

Tech Divergence loads about 1.3k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 379 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
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 WellApp-ai/Well at commit c740217, republished under its MIT licence (© WellApp-ai). 379 words, ~1,309 tokens.

Download SKILL.mdSave it as .claude/skills/tech-divergence/SKILL.md (or your agent's skills folder).
name
tech-divergence
description
Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

Tech Divergence Skill

Evaluate technical implementation options using an 8-dimension scoring matrix. Low scores auto-proceed; high scores (>= 4) trigger Gate 4 for human decision.

When to Use

  • During Plan Mode Phase 2 (Technical Diverge)
  • Before committing to a specific architecture or pattern
  • When multiple valid implementation approaches exist

Scoring Matrix (8 Dimensions)

Each dimension scores 0 (auto-proceed) or 1 (adds to checkpoint score):

Dimension0 (Low Risk)1 (Checkpoint)
PatternExists in codebaseNew pattern required
ScopeSingle domainCross-domain impact
Data ModelAdd field to existingNew entity/table
DependenciesUse existing libsNew dependency
API SurfaceInternal onlyPublic/breaking change
ReversibilityEasy to undoRequires migration
SecurityNon-sensitive dataAuth/permissions
PerformanceSimple CRUDCache/queue/optimization

Phase 1: Gather Context

1.1 Query Pattern Library (Notion)

Check if similar patterns exist:

API-query-database:
  database_id: "[PATTERN_LIBRARY_DB_ID]"
  filter:
    property: "Domain"
    select:
      equals: "[current domain]"
1.2 Search Codebase
SemanticSearch: "How is [similar feature] implemented?"
Grep: "[pattern name]" in relevant directories
1.3 Query Context7 (External Libraries)

If new libraries are being considered:

Context7 MCP:
1. resolve-library-id: libraryName = "[library]"
2. get-library-docs: topic = "best practices", mode = "info"

Phase 2: Score Each Dimension

For each of the 8 dimensions, evaluate and score:

## Technical Divergence Score

| Dimension | Score | Rationale |
|-----------|-------|-----------|
| Pattern | 0/1 | [Exists/New] |
| Scope | 0/1 | [Single/Cross-domain] |
| Data Model | 0/1 | [Field/Entity] |
| Dependencies | 0/1 | [Existing/New] |
| API Surface | 0/1 | [Internal/Public] |
| Reversibility | 0/1 | [Easy/Migration] |
| Security | 0/1 | [Non-sensitive/Auth] |
| Performance | 0/1 | [CRUD/Optimization] |
| **TOTAL** | [0-8] | |

Phase 3: Determine Path

If Score < 4: Auto-Proceed
## Technical Approach: Auto-Proceed

**Score:** [N]/8 (below threshold)

**Selected Approach:** [Describe the approach]

**Rationale:** 
- Pattern exists: [reference]
- Low cross-domain impact
- Easy to reverse if needed

Proceeding to Commit Plan...
If Score >= 4: Gate 4 (Human Checkpoint)
## Gate 4: Technical Approach Selection

**Score:** [N]/8 (threshold reached)

**Why human input needed:**
- [List dimensions that scored 1]

### Option A: [Name] (Conservative)

**Approach:** [Description]
**Effort:** S
**Risk:** Low
**Trade-off:** [What you give up]

### Option B: [Name] (Balanced)

**Approach:** [Description]
**Effort:** M
**Risk:** Medium
**Trade-off:** [What you give up]

### Option C: [Name] (Bold)

**Approach:** [Description]
**Effort:** L
**Risk:** Higher
**Trade-off:** [What you give up]

---

**Which approach would you like to proceed with?** (A / B / C)

*If you reject an option, I'll invoke decision-capture to record why.*

Phase 4: Record Decision

After Gate 4 selection:

  1. If option rejected, invoke decision-capture skill
  2. Record selected approach in context for Commit Plan
  3. Update Pattern Library if new pattern established

Integration with Plan Mode

This skill is invoked during Plan Mode Phase 2:

Plan Mode Flow:
Phase 1: APPETITE → 
Phase 2: TECHNICAL DIVERGE (this skill) →
  If score < 4: Auto-proceed
  If score >= 4: Gate 4 → Human selects
Phase 3: COMMIT PLAN
Show full SKILL.md (162 more words)Show less

MCP Tools Used

ToolPurpose
Notion MCPQuery Pattern Library database
Context7 MCPGet library best practices
SemanticSearchFind existing codebase patterns
GrepSearch for specific implementations

Example Scoring

Low Score Example (Auto-Proceed)

Feature: Add a new column to existing table

DimensionScoreRationale
Pattern0Column additions done before
Scope0Single domain (tables)
Data Model0Adding field, not entity
Dependencies0Using existing libs
API Surface0Internal only
Reversibility0Easy migration
Security0Non-sensitive data
Performance0Simple CRUD
TOTAL0Auto-proceed
High Score Example (Gate 4)

Feature: Add real-time collaboration

DimensionScoreRationale
Pattern1No WebSocket patterns yet
Scope1Affects auth, tables, workflows
Data Model1New presence entity
Dependencies1Need socket.io
API Surface1New WS endpoints
Reversibility1Would need cleanup migration
Security1User session handling
Performance1Needs connection pooling
TOTAL8Gate 4 required

Invocation

Invoked automatically by Plan Mode Phase 2, or manually with "use tech-divergence skill".

© WellApp-ai, 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 cursor-rules/skills/tech-divergence of WellApp-ai/Well.

Open the folder on GitHubat commit c740217

Compare with similar skills

Tech Divergence 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.

Tech Divergence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tech Divergence this skillWellApp-ai/Well345—~1.3kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k11 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official38k8 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed

More from WellApp-ai/Well

All 36 skills in this repo
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated yesterday
    Auto-check passed
  • Autonomous Loop

    WellApp-ai/Well

    Iterate until success or limit, composing existing skills with Jidoka integration

    345 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Balance Sheet

    WellApp-ai/Well

    Build a balance sheet (bilan) from a Well workspace. An agent skill from WellApp-ai/Well.

    345 GitHub stars~534 tokensUpdated yesterday
    Auto-check passed
  • Bpmn Workflow

    WellApp-ai/Well

    Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

    345 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Cash Flow Forecast

    WellApp-ai/Well

    Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions.

    345 GitHub stars~567 tokensUpdated yesterday
    Auto-check passed
  • Code Review

    WellApp-ai/Well

    Review code changes against hard rules and conventions. An agent skill from WellApp-ai/Well.

    345 GitHub stars~509 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Tech Divergence

What does Tech Divergence do?

Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions. Tech Divergence is an agent skill from WellApp-ai/Well.

When should I use Tech Divergence?

Tech Divergence fits situations like: gate 4 for significant decisions.

How do I install Tech Divergence in Claude Code?

Run `npx skills add WellApp-ai/Well --skill tech-divergence -a claude-code`. Or copy the skill folder (cursor-rules/skills/tech-divergence in WellApp-ai/Well) into .claude/skills/tech-divergence in your project. Claude Code loads it when a task matches its description.

How do I install Tech Divergence in Codex?

Run `npx skills add WellApp-ai/Well --skill tech-divergence -a codex`. Or copy the skill folder (cursor-rules/skills/tech-divergence in WellApp-ai/Well) into .agents/skills/tech-divergence in your project. Codex loads it when a task matches its description.

Can I use Tech Divergence 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 WellApp-ai/Well --skill tech-divergence -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tech-divergence, .gemini/skills/tech-divergence, .github/skills/tech-divergence and .opencode/skills/tech-divergence in your project.

What does Tech Divergence need to run?

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

Does Tech Divergence 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 Tech Divergence 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 Tech Divergence use?

Tech Divergence 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 Tech Divergence use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Tech Divergence?

Skills that share tags, products or a category with Tech Divergence: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tech Divergence?

WellApp-ai (a GitHub organization) maintains it in WellApp-ai/Well, which has 345 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 7, 2026.

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