/attributes:collect
Collect structured codebase health attributes with severity and remediation actions.
When to Use This Skill
| Use this skill when... | Use another approach when... |
|---|---|
| Need structured health assessment before routing | Quick health score only (use /health:check) |
| Want machine-readable attribute JSON | Human-readable report (use /attributes:dashboard) |
| Planning which agents to invoke | Already know what needs fixing |
| Comparing health across repos | Checking specific component only |
Parameters
| Parameter | Description |
|---|---|
--output <path> | Write JSON to file (default: stdout) |
--categories <list> | Comma-separated categories to check: docs,tests,security,quality,ci |
Execution
Perform these checks and output structured JSON.
Step 1: Documentation Attributes
Check for these files and emit attributes:
| Check | Attribute ID | Severity |
|---|---|---|
| README.md exists | missing-readme | high |
| README.md > 200 chars | short-readme | low |
| CLAUDE.md exists | missing-claude-md | medium |
| docs/ directory exists | no-docs-directory | low |
| LICENSE file exists | missing-license | low |
Score: Start at 0, add points per check (max 20).
Step 2: Testing Attributes
| Check | Attribute ID | Severity |
|---|---|---|
| tests/ or test/ directory exists | no-test-directory | high |
| Test config file exists (vitest, jest, pytest, etc.) | no-test-config | medium |
| CI workflow runs tests | no-ci-tests | high |
Test configs to look for: vitest.config.{ts,js}, jest.config.{js,ts}, pytest.ini, conftest.py, playwright.config.ts
Step 3: Security Attributes
| Check | Attribute ID | Severity |
|---|---|---|
| .gitignore exists | missing-gitignore | high |
| .env file NOT committed | env-file-committed | critical |
| Pre-commit hooks configured | no-pre-commit-hooks | medium |
| Security scanning in CI | no-security-scanning | high |
| Dependabot configured | no-dependabot | low |
Step 4: Code Quality Attributes
| Check | Attribute ID | Severity |
|---|---|---|
| Linter configured (eslint, biome, ruff) | no-linter-configured | medium |
| Formatter configured (prettier, biome, ruff) | no-formatter | medium |
| Type checking (tsconfig, pyright, mypy) | no-type-checking | low |
Step 5: CI/CD Attributes
| Check | Attribute ID | Severity |
|---|---|---|
| CI workflows exist | no-ci-workflows | high |
| Workflows dir has files | empty-workflows-dir | medium |
Step 6: Output
Output JSON matching this schema:
{
"version": "1",
"repo": "<path>",
"timestamp": "<ISO 8601>",
"attributes": [
{
"id": "missing-readme",
"category": "docs",
"severity": "high",
"description": "Missing README.md",
"source": "attributes-collect",
"actions": [
{"type": "agent", "target": "docs", "args": "create README.md", "auto_fixable": true}
]
}
],
"scores": {
"overall": 72,
"grade": "C",
"max_score": 100,
"categories": {"docs": 15, "tests": 12, "security": 8, "quality": 17, "ci": 20}
}
}
If --output is specified, write the JSON to that file.
Agentic Optimizations
| Context | Command |
|---|---|
| Full attribute collection | /attributes:collect |
| Save to file | /attributes:collect --output .claude/attributes.json |
| Specific categories | /attributes:collect --categories security,tests |
| Check README exists | test -f README.md && echo exists || echo missing |
| Check test dir | test -d tests || test -d test && echo exists || echo missing |
| Count README chars | wc -c < README.md 2>/dev/null || echo 0 |