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.