One-click install
npx skills add https://github.com/watmin/datamancy.dev --skill probare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: probare
Source: https://github.com/watmin/datamancy.dev/tree/main/probare
Command: npx skills add https://github.com/watmin/datamancy.dev --skill probare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

probare helps determine whether a file primarily contains executable code or prose, preventing misinterpretation of specifications or documentation.

Core Features & Use Cases

  • Substance assessment: analyzes the density of executable forms vs prose to classify content as code-like or prose-like.
  • Content honesty checks: detects placeholders, TODOs, and alignment gaps between declared purpose and actual content.
  • Decision guidance: provides recommendations on renaming, restructuring, or shipping as-is based on substance.

Quick Start

Run probare on a target file to determine whether it is a substantive program or a prose description.

Frequently Asked Questions about probare

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

FAQPage Schema
How do I check if a file contains executable code or prose descriptions?

To check if a file contains executable code or prose descriptions, you analyze its substance density by parsing executable forms against prose text. This evaluation outputs a structured verdict classifying the content type and highlighting any placeholders.

What is static analysis for documentation quality and substance evaluation?

Static analysis for documentation quality evaluates file content to determine its true substance by parsing executable forms versus prose. It detects placeholders and TODOs, checks alignment with declared purpose, and provides structured decision guidance.

How do I detect placeholders and TODOs in source code and design documents?

You detect placeholders and TODOs in source code and design documents by running content honesty checks. This analysis scans for alignment gaps between declared purpose and actual content, highlighting incomplete sections and evaluating form density.

Can I evaluate form density in README files to determine if they are substantive?

Yes, you can evaluate form density in README files to determine if they are substantive. Analyzing the ratio of executable forms to prose descriptions classifies whether the file contains a substantive program or merely prose documentation.

When do I need to run a substance analysis on specifications?

You need to run a substance analysis on specifications when preventing the misinterpretation of documentation. It determines whether a spec file contains executable code or prose descriptions, identifies alignment gaps with declared purpose, and suggests restructuring next steps.

What are the limitations of code detection in prose-heavy specification files?

A limitation of code detection in prose-heavy specification files is its focus on substance density and form parsing rather than logic validation. While it highlights placeholders and TODOs, it does not execute or validate the detected executable forms.