Agent skill

Team Diagnose

by tikalk in tikalk/adlc-team-skills

A skill your agent uses when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules —…

MITAuto-check passedTesting & QA

Install Team Diagnose

skills CLI
$ npx skills add tikalk/adlc-team-skills --skill team-diagnose -a claude-code

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

GitHub CLI
$ gh skill install tikalk/adlc-team-skills team-diagnose --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/tikalk/adlc-team-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/team/team-diagnose .claude/skills/team-diagnose && 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
team-diagnose
GitHub stars
141
Token cost
~806 tokens
SKILL.md length
395 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules —…

  • The team context did not appear at session start
  • SKILL.md covers Overview, When to Use, Core Process and Report format, plus 2 more sections
  • Calls bash, pytest and npx
  • A skill failed to trigger

What it does

Team Diagnose is an agent skill from tikalk/adlc-team-skills. Use when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules — walks the failure chain with commands and evidence before any conclusion.

Its SKILL.md is about 810 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 Testing & QA. The repository describes itself as: Agent skills for the Agentic SDLC: team lifecycle (team-boot, team-learn, team-init, team-repair), software factory, evals, CDR lifecycle with confidence scoring, and… The licence is MIT.

When your agent uses it

  • The team context did not appear at session start
  • A skill failed to trigger
  • The install behaves unexpectedly
  • Someone asks why a session ran without team rules — walks the failure chain with commands and evidence before any conclusion

Example prompts

  • “/team-diagnose”

Requirements

  • Node.js

What it can do on your machine

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

    • bash
    • pytest
    • npx

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

Team Diagnose loads about 806 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 395 words of instructions outside code blocks.

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

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 tikalk/adlc-team-skills at commit 4c4ad44, republished under its MIT licence (© tikalk). 395 words, ~806 tokens.

Download SKILL.mdSave it as .claude/skills/team-diagnose/SKILL.md (or your agent's skills folder).
name
team-diagnose
description
Use when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules — walks the failure chain with commands and evidence before any conclusion.

team-diagnose

Overview

Evidence-first diagnosis of broken adlc-team-skills wiring. The chain has exactly five links, each checkable with one command — a diagnosis without command output is a guess, and guesses get pasted into bug reports.

Boundary: this repo owns .events.json and the boot scripts' output. The injection side (dispatchers, generated per-agent plugins) is owned by adlc-cli — the docs/event-hook-contract.md file in the adlc-team-skills repo draws the line. Diagnose up to it, then route.

When to Use

  • Team context missing at session start (no Team Context & Decisions section).
  • A rule that should have matched didn't load.
  • Install behaves unexpectedly after an update.

When NOT to use: for application bugs unrelated to the team-context chain, or for skill behavior debates (that's a goldset/eval question).

Core Process

Run the checks in order — stop at the first failure, fix, re-run:

#Symptom areaCheck (run it)Green means
1Not configuredcat .adlc/init-options.jsonA team_ai_directives path that exists
2Missing toolcommand -v jqjq on PATH (skills registry needs it)
3Broken handlerbash .agents/skills/team-boot/scripts/boot.sh from the project rootThe directives index on stdout, wrapped in EXTREMELY_IMPORTANT
4Stale installpytest tests/unit/test_generated_artifacts_sync.py -q (in the skills repo) or compare skills/**/SKILL.md vs .agents/skills/ namesMirror matches source
5Injection sideGenerated plugin present and loaded for the agent?If 1–4 are green and the session still lacks context → adlc-cli's territory — file there with the outputs of checks 1–4 attached

For "a rule didn't load" specifically: confirm the session began with the index (check 3's content), then check the task actually matched the rule's descriptor — on-demand pull is match-driven, not mind-reading.

Whole-loop check: scripts/acceptance-test.sh scratch-installs and asserts the chain end-to-end (add --live for a real agent session).

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

Report format

For a bug report, include: the failing check number, the command, its verbatim output, agent name/version, and how the repo was installed (npx skills add vs adlc-cli). No scrubbed narrative — raw output.

Red Flags

  • Concluding before running a command — every check is one command.
  • "Reinstall everything" before reading check 3's output.
  • Blaming a skill's content when check 1–3 failed (config, not skills).
  • Filing injection-side bugs in adlc-team-skills (check 5 routes them).

All of these mean: run the checks, then report.

Verification

A diagnosis is done when:

  • Checks 1–4 each ran with output captured (or 5 routed with evidence)
  • The failing link is named with its command output
  • The report routes to the owning repo

© tikalk, 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 skills/team/team-diagnose of tikalk/adlc-team-skills.

Open the folder on GitHubat commit 4c4ad44

Compare with similar skills

Team Diagnose 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.

Team Diagnose compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Team Diagnose this skilltikalk/adlc-team-skills141—~806Automated safety check: PassMIT
Pester Failure AnalysisPowerShell/PowerShell56k—~5.1kAutomated safety check: PassMIT
Rust TDD Workflowrtk-ai/rtk83k—~753Automated safety check: NotesApache-2.0
Clawteam DevHKUDS/ClawTeam5.5k1 repos~1.1kAutomated safety check: PassMIT
Browser Testing with Chrome DevToolsaddyosmani/agent-skills103k4 repos~3.5kAutomated safety check: WarnMIT
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT

Similar skills

  • Pester Failure Analysis

    PowerShell/PowerShell

    Investigates failing Pester tests in PowerShell CI jobs by following a six-step workflow from pull request status to documented fix recommendations.

    56k GitHub stars~5.1k tokensUpdated today
    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
  • Clawteam Dev

    HKUDS/ClawTeam

    A skill your agent uses when working inside the ClawTeam repository itself: local development, debugging, reviewing, testing, validating multi-agent flows, or checking whether a code change actually…

    5.5k GitHub starsUsed in 1 repo~1.1k tokens
    Testing & QAAuto-check passed
  • Connects an agent to a real Chrome instance through the Chrome DevTools MCP server, so it can inspect the DOM, read console errors and profile performance directly.

    103k GitHub starsUsed in 4 repos~3.5k tokens
    Testing & QAAuto-check: warnings
  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check passed

More from tikalk/adlc-team-skills

All 44 skills in this repo
  • Team Boot

    tikalk/adlc-team-skills

    A skill your agent uses when a session starts or resumes after compaction (auto via the sessionstart and sessioncompact event hooks) and the team AI directives context — constitution, CDR index…

    141 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Architect Clarify

    tikalk/adlc-team-skills

    A skill your agent uses when ADRs need review, gaps need filling, or ADR status must be approved as Accepted before architecture generation.

    141 GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Change Clarify

    tikalk/adlc-team-skills

    A skill your agent uses when reviewing, accepting, rejecting, or deferring ChDRs mined by change-init, validating inferred decisions against their git and issue evidence before promotion to project…

    141 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Change Init

    tikalk/adlc-team-skills

    A skill your agent uses when you want guided mining of git history, structured change-story clustering, or comprehensive rationale recovery before documenting.

    141 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Change Publish

    tikalk/adlc-team-skills

    A skill your agent uses when accepted ChDRs are ready for promotion from drafts to project memory at docs/adlc/memory/chdr/ and the boot-facing chdr.md index needs regenerating.

    141 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Evals Analyze

    tikalk/adlc-team-skills

    A skill your agent uses when evaluation results need triage and loop-closing — spec failures route to deterministic checks or context rules, generalization failures to the evaluator backlog.

    141 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Team Diagnose

What does Team Diagnose do?

A skill your agent uses when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules —…. Team Diagnose is an agent skill from tikalk/adlc-team-skills. Use when the team context did not appear at session start, a skill failed to trigger, the install behaves unexpectedly, or someone asks why a session ran without team rules — walks the failure chain with commands and evidence before any conclusion.

When should I use Team Diagnose?

Team Diagnose fits situations like: the team context did not appear at session start; A skill failed to trigger; the install behaves unexpectedly; someone asks why a session ran without team rules — walks the failure chain with commands and evidence before any conclusion.

How do I install Team Diagnose in Claude Code?

Run `npx skills add tikalk/adlc-team-skills --skill team-diagnose -a claude-code`. Or copy the skill folder (skills/team/team-diagnose in tikalk/adlc-team-skills) into .claude/skills/team-diagnose in your project. Claude Code loads it when a task matches its description.

How do I install Team Diagnose in Codex?

Run `npx skills add tikalk/adlc-team-skills --skill team-diagnose -a codex`. Or copy the skill folder (skills/team/team-diagnose in tikalk/adlc-team-skills) into .agents/skills/team-diagnose in your project. Codex loads it when a task matches its description.

Can I use Team Diagnose 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 tikalk/adlc-team-skills --skill team-diagnose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/team-diagnose, .gemini/skills/team-diagnose, .github/skills/team-diagnose and .opencode/skills/team-diagnose in your project.

What does Team Diagnose need to run?

Going by SKILL.md and its folder, Team Diagnose needs the command-line tools its instructions call (bash, pytest and npx). Our summary lists: Node.js.

Does Team Diagnose access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Team Diagnose 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 Team Diagnose use?

Team Diagnose 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 Team Diagnose use?

About 806 tokens (SKILL.md is roughly 3.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 Team Diagnose?

Skills that share tags, products or a category with Team Diagnose: Pester Failure Analysis (PowerShell/PowerShell, 56k stars), Rust TDD Workflow (rtk-ai/rtk, 83k stars), Clawteam Dev (HKUDS/ClawTeam, 5.5k stars) and Browser Testing with Chrome DevTools (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Team Diagnose?

tikalk (a GitHub organization) maintains it in tikalk/adlc-team-skills, which has 141 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 8, 2026.

Source: tikalk/adlc-team-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.