skills.rest
ThonkTank
ThonkTankCOMMUNITY
Explore all skills by this author →
GitHub

project-health

Scan SaltMarcher project for architectural, quality, and governance debt.

Updated Aug 26, 2025
Search Tags:#code review#software architecture#debt management#project health#project integrity
One-click install
npx skills add https://github.com/ThonkTank/Salt-Marcher --skill project-health-thonktank
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-health
Source: https://github.com/ThonkTank/Salt-Marcher/tree/main/tools/quality/skills/project-health
Command: npx skills add https://github.com/ThonkTank/Salt-Marcher --skill project-health-thonktank

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps prevent structural and governance debt in the SaltMarcher project by providing a comprehensive health check before any changes are made.

Core Features & Use Cases

  • Preventive Analysis: Identifies potential architecture, quality, or governance issues before they become ingrained.
  • Review Workflow: Defines the review and handoff process for findings, ensuring that supported debt is resolved.
  • Scalable Debt Management: Manages project debt entries and ensures that they are properly synchronized and reclassified before handoff.

Quick Start

Run the project-health skill to check the health of your SaltMarcher project before planning, implementing, or refactoring.

Frequently Asked Questions about project-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify and manage architectural debt before refactoring a project?▼

To manage architectural debt before refactoring, run a preventive project health check to identify potential architecture, quality, or governance issues and resolve the findings before any changes are made.

What is project governance debt and how does a health check prevent it?▼

Project governance debt occurs when structural policies are bypassed. A health check prevents it by scanning for unsupported debt entries and ensuring they are properly reclassified before handoff.

How do I run a code review workflow for software architecture findings?▼

You run a code review workflow by scanning the codebase for architecture issues, then following the defined review and handoff process to ensure supported debt is resolved.

Do I need defined owner areas and workflows to manage project integrity?▼

Yes, managing project integrity requires the project to have defined owner areas and workflows so that identified architectural and governance debt can be properly assigned and synchronized.

Can Python scripts automate debt management and synchronization for a codebase?▼

Yes, Python scripts can automate debt management by scanning the project, managing debt entries, and ensuring all identified issues are synchronized and reclassified before handoff.

When should I use a preventive project health check in the software development lifecycle?▼

Use a preventive project health check before planning, implementing, or refactoring phases to catch structural and governance debt early, ensuring it is resolved before it becomes ingrained.

Related Skills

Explore More Software Engineering Skills→
samjhechtsamjhecht
4

initialize-governance

Generate Constitution, Roadmap, and process documentation templates for project governance.

Community
Advanced
SailfishcSailfishc

gf-doc-review

Extract goal, state, evidence, risks, and next actions from project docs.

Community
Intermediate
VoDaiLoczVoDaiLocz
24

lint-and-validate

Automate linting and static analysis of code in CI pipelines.

Community
Intermediate
DauQuangThanhDauQuangThanh
14

code-quality-review

Detect code smells and measure complexity in repositories.

Community
Advanced