epistemic-code-voice

Enforce epistemic humility and anti-ocular language in code-related prose.

Updated Sep 10, 2024
One-click install
npx skills add https://github.com/TioSavich/UMEDCTA --skill epistemic-code-voice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: epistemic-code-voice
Source: https://github.com/TioSavich/UMEDCTA/tree/main/.claude/skills/epistemic-code-voice
Command: npx skills add https://github.com/TioSavich/UMEDCTA --skill epistemic-code-voice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enforce epistemic humility, anti-ocular language, philosophical terminological consistency, and anti-schlock prose across code, comments, docstrings, UI copy, README, and website text. Synthesizes Carspecken's anti-picture-thinking, the project's philosophical dictionary, and deschlocker patterns to ensure prose does not reveal meta-commentary or hand-holding, while preserving code logic.

Core Features & Use Cases

  • Epistemic humility enforcement: ensures prose in code artifacts invites understanding rather than claiming authority.
  • Anti-ocular language: removes picture-thinking in non-technical prose while preserving technical terms.
  • Philosophical coherence: checks dictionary term usage and cross-references to reflect intended meanings.
  • Anti-schlock guidelines: reduces AI-style parallelisms and foreclosing rhetoric in README/docs/UI; code remains exempt.

Quick Start

Run a review of your latest code changes to replace ocular metaphors with humble, dictionary-consistent wording in all prose.

Frequently Asked Questions about epistemic-code-voice

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

FAQPage Schema
How do I enforce epistemic humility in code comments and README documentation?

You can enforce epistemic humility by reviewing code comments, docstrings, and README files to replace authoritative or ocular phrasing with wording that invites understanding. This process checks surface-level ocular phrasing and rewrites prose to align with project dictionary rules.

What is anti-ocular language and how does it apply to technical documentation?

Anti-ocular language removes picture-thinking metaphors from non-technical prose while preserving required technical terms. In documentation, it prevents surface-level ocular phrasing from obscuring philosophical coherence and enforces epistemic humility across code-facing contexts like UI copy and READMEs.

How do I check docstrings and UI copy for philosophical dictionary term consistency?

You can check docstrings and UI copy for philosophical dictionary term consistency by running a prose review that cross-references used terms against the project's philosophical dictionary. This verifies that terminology usage reflects intended meanings across code-related artifacts.

Does the epistemic code prose review modify code logic or only comments?

The epistemic code prose review only modifies comments, docstrings, UI copy, and README text while strictly preserving code logic. It targets code-related prose to enforce epistemic humility and anti-schlock guidelines without altering functional code behavior.

What are the limitations of using anti-schlock guidelines for code prose?

A key limitation of anti-schlock guidelines is that code remains exempt from deschlocker patterns; the rules only apply to prose. The guidelines reduce AI-style parallelisms and foreclosing rhetoric in README, docs, and UI copy, but do not enforce functional code structure.

Why does my README documentation contain AI-style parallelisms and how do I remove them?

README documentation often contains AI-style parallelisms due to foreclosing rhetoric generated by AI tools. You remove them by applying anti-schlock guidelines that reduce AI-style parallelisms, ensuring prose aligns with epistemic humility and anti-picture-thinking rules.