# Assess

> Multi-phase project assessment with scoring. Triggered by "/assess" to evaluate project health across dimensions and generate a comprehensive report.

- Skill: `x-cmd/assess` (Agent Skill)
- Install (CLI): `npx skillmds@latest add x-cmd/assess`
- Raw SKILL.md: https://api.skillmd.com/api/skills/x-cmd/assess/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: x-cmd (https://skillmd.com/u/x-cmd)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/x-cmd/assess

---


# Project Assessor

## Trigger

Use when:
- User says `/assess`
- User wants overall project health evaluation
- Multi-dimensional analysis needed

Do NOT use when:
- User wants quick scan (use `/scan`)
- User wants rule-by-rule check (use `/check`)

## Steps

### Step 1: Discover Targets

Generate `target.tsv` mapping each file to applicable rules.

```
root    target    rule-to-check
./      src/auth.sh    P06-var-010 P06-var-020
```

### Step 2: Score Each Pair

Generate `result/<rule-id>.tsv` for each rule.

```
target    score    hint
src/auth.sh  90    variable naming issue
```

Scoring: 0-100 (100 = full compliance)

### Step 3: Summarize

Aggregate into comprehensive report.

## Output Format

```markdown
## Assessment Summary

### Overall Score: [N]/100

### Rules Breakdown
| Rule | Score | Issues |
|------|-------|--------|
| ... | ... | ... |

### Top Violations
1. [file:line — issue]

### Recommendations
- [Action items]
```

If no ruleset available, use general heuristics:
- Code health, dependencies, documentation, security, complexity, CI/CD

## Constraints

- Always produce a summary score
- If ruleset unavailable, fallback to general heuristics
- Do NOT auto-fix