Agent skill

Project Health

by davekilleen in davekilleen/Dex

Scan active projects for status, blockers and next actions. An agent skill from davekilleen/Dex.

MITAuto-check passed

Install Project Health

skills CLI
$ npx skills add davekilleen/Dex --skill project-health -a claude-code

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

GitHub CLI
$ gh skill install davekilleen/Dex project-health --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/davekilleen/Dex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/project-health .claude/skills/project-health && 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
project-health
GitHub stars
494
Token cost
~739 tokens
SKILL.md length
304 words
Files
1
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Scan active projects for status, blockers and next actions. An agent skill from davekilleen/Dex.

  • Works in 3 steps: Scan Projects → Check Each Project → Output Dashboard
  • The user says how are my projects
  • SKILL.md covers What This Does, Process, Status Meanings and When to Use, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Health is an agent skill from davekilleen/Dex. Scan active projects for status, blockers and next actions. Use when the user says 'how are my projects', 'what's stuck', 'project status'. Also use proactively when projects have gone quiet. Not for writing a spec for a new product idea; use product-brief.

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

The repository describes itself as: Your AI Chief of Staff — a personal operating system starter kit that adapts to your role. No coding required. The licence is MIT.

When your agent uses it

  • The user says how are my projects

Example prompts

  • “how are my projects”
  • “s stuck”
  • “project status”
  • “/project-health”

Workflow steps

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

  1. Scan Projects
  2. Check Each Project
  3. Output Dashboard

What it can do on your machine

Read from SKILL.md and the folder at commit d0ffc6b. 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 bash and markdown).

    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

Project Health loads about 739 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 304 words of instructions outside code blocks.

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

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 davekilleen/Dex at commit d0ffc6b, republished under its MIT licence (© davekilleen). 304 words, ~739 tokens.

Download SKILL.mdSave it as .claude/skills/project-health/SKILL.md (or your agent's skills folder).
name
project-health
description
Scan active projects for status, blockers and next actions. Use when the user says 'how are my projects', 'what's stuck', 'project status'. Also use proactively when projects have gone quiet. Not for writing a spec for a new product idea; use `product-brief`.
<!-- Generated from `.claude/skills/project-health/SKILL.md` by `scripts/generate-agents-skills.py`. Do not edit. -->

Quick scan of all active projects to see what's stalled, blocked, or needs attention.

What This Does

Checks each project in 04-Projects/ for:

  1. Activity levels (when was project last touched?)
  2. Week Priorities presence (does project have active tasks?)
  3. Blockers (anything blocking progress?)
  4. Next steps clarity (is the next action clear?)

Process

Step 1: Scan Projects

List all projects in 04-Projects/:

bash
ls -la 04-Projects/
Step 2: Check Each Project

For each project folder or file:

Activity Check:

  • Get last modification time
  • 7 days without activity = yellow

  • 14 days without activity = red

Week Priorities Presence:

  • Scan 00-Inbox/Weekly_Plans.md for project mentions
  • No tasks for 2+ weeks = yellow

Blocker Check:

  • Look for "blocked", "waiting on", "stuck" in project notes
  • Any logged blocker = red

Next Step Clarity:

  • Check if there's a clear next action
  • No next step = yellow
Step 3: Output Dashboard
markdown
### Project Health Dashboard

| Project | Status | Issue | Days Since Activity |
|---------|--------|-------|---------------------|
| [Project A] | 🟢 | On track | 2 |
| [Project B] | 🟡 | No active tasks | 8 |
| [Project C] | 🔴 | Blocked - waiting on [X] | 15 |

**Summary:** [N] projects ([X] 🟢 / [Y] 🟡 / [Z] 🔴)

Status Meanings

  • 🟢 Green: Active, clear next steps, no blockers
  • 🟡 Yellow: Stale 7-14 days, OR no active tasks, OR unclear next step
  • 🔴 Red: Blocked, OR stale 14+ days

When to Use

  • Weekly planning to check project health
  • When feeling disconnected from the big picture
  • Before 1:1s to surface blocked projects
  • When deciding what to work on next

Follow-up Actions

For yellow projects:

  • Add a task to Week Priorities
  • Clarify next step in project notes

For red projects:

  • Identify what's blocking progress
  • Escalate if needed
  • Or decide to pause/archive the project

Track Usage (Silent)

Call the mark_feature_used tool on the dex-analytics MCP server with project-health. This ticks the feature's box in System/usage_log.md, which is what /dex-level-up reads to recommend features that have not been tried. It writes locally and sends nothing, so it runs whether or not analytics is enabled.

Analytics (Silent):

Call track_event with event_name project_health_checked and properties:

  • projects_reviewed
  • blockers_found

This only fires if the user has opted into analytics. No action needed if it returns "analytics_disabled".

© davekilleen, 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 .agents/skills/project-health of davekilleen/Dex.

Open the folder on GitHubat commit d0ffc6b

Compare with similar skills

Project Health 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.

Project Health compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Health this skilldavekilleen/Dex494—~739Automated safety check: PassMIT
Scanwshobson/agents40k—~2.2kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.5kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.3kAutomated safety check: PassMIT
Vulnerability Scanningsickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT
Performing Ot Vulnerability Scanning Safelymukul975/Anthropic-Cybersecurity-Skills34k—~2.9kAutomated safety check: PassApache-2.0

Similar skills

  • Scan

    wshobson/agents

    Scans the codebase to generate project-doc.md and AGENTS.md.

    40k GitHub stars~2.2k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Repo Scan

    affaan-m/ECC

    固定されレビュー可能なコミットから外部の repo-scan スキルをインストールするブートストラップ用ポインター。クロススタックのソースコード資産監査を実行する前に repo-scan のインストールが必要な場合に使用する。この ECC ポインター自体は監査を実行しない。

    276k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Repo Scan

    affaan-m/ECC

    用于从固定且可审查的提交安装外部 repo-scan 技能的引导指针。在运行跨栈源代码资产审计前需要安装 repo-scan 时使用;此 ECC 指针本身不执行审计。

    276k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Vulnerability Scanning

    sickn33/agentic-awesome-skills

    Scan systems and dependencies for CVEs and security vulnerabilities.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    SecurityAuto-check passed
  • Performing Ot Vulnerability Scanning Safely

    mukul975/Anthropic-Cybersecurity-Skills

    Perform vulnerability scanning in OT/ICS environments safely using passive monitoring, native protocol queries, and carefully controlled active scanning with Tenable OT Security to identify…

    34k GitHub stars~2.9k tokensUpdated 1 mo ago
    SecurityAuto-check passed
  • Skin Health Analyzer

    sickn33/agentic-awesome-skills

    Analyze skin health data, identify skin problem patterns, assess skin health status.

    47k GitHub starsUsed in 2 repos~293 tokens
    Productivity & AutomationAuto-check passed

More from davekilleen/Dex

All 61 skills in this repo
  • Dspy Ruby

    davekilleen/Dex

    This skill should be used when working with DSPy.rb, a Ruby framework for building type-safe, composable LLM applications.

    494 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • Diff Adopt Profile

    davekilleen/Dex

    Adopt a full published Heydex profile by handle ('set me up like @davekilleen').

    494 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Diff Generate

    davekilleen/Dex

    Package one workflow — how you use Dex for a specific job — into a shareable DexDiff methodology doc.

    494 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Creating Agent Skills

    davekilleen/Dex

    Expert guidance for creating, writing, and refining Claude Code Skills.

    494 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Feedback

    davekilleen/Dex

    Report a Dex bug to the Dex team with zero homework — Dex investigates locally, builds a privacy-safe report, shows it to you (or auto-sends if you've chosen that), and tracks the ticket until it's…

    494 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Dhh Rails Style

    davekilleen/Dex

    This skill should be used when writing Ruby and Rails code in DHH's distinctive 37signals style.

    494 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed

Questions about Project Health

What does Project Health do?

Scan active projects for status, blockers and next actions. An agent skill from davekilleen/Dex. Project Health is an agent skill from davekilleen/Dex. Scan active projects for status, blockers and next actions.

When should I use Project Health?

Project Health fits situations like: the user says how are my projects.

How do I install Project Health in Claude Code?

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

How do I install Project Health in Codex?

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

Can I use Project Health 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 davekilleen/Dex --skill project-health -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-health, .gemini/skills/project-health, .github/skills/project-health and .opencode/skills/project-health in your project.

What does Project Health need to run?

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

Does Project Health 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 Project Health 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 Project Health use?

Project Health 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 Project Health use?

About 739 tokens (SKILL.md is roughly 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 Project Health?

Skills that share tags, products or a category with Project Health: Scan (wshobson/agents, 40k stars), Repo Scan (affaan-m/ECC, 276k stars), Repo Scan (affaan-m/ECC, 276k stars) and Vulnerability Scanning (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Health?

davekilleen (a GitHub user) maintains it in davekilleen/Dex, which has 494 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 9, 2026.

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