What is the Evidence Hierarchy in this skill?

It is a verification system that prioritizes facts observed directly in code or official docs over synthesis, user reports, or intuition.

How does it handle audience targeting?

It uses a scoring system to distribute 100 points between human and agent audiences, ensuring the content is structured for the primary reader's needs.

What document types does this skill support?

It supports a wide range of types including North-Star, Gestalt, Reference, Research, Design, Plan, Flow, Findings, Concepts, and Process documents.

Why does it prohibit timestamps and words like 'currently'?

These elements quickly become outdated or misleading; the skill relies on Git history for temporal tracking to ensure the documentation remains evergreen.

Writing Documents (RepoQL)

Name: Writing Documents (RepoQL)
Author: stueeey

bystueeey

0•

Learning & Documentation

Guides the creation of high-quality, verified documentation while preventing the spread of incorrect information.

The Writing Documents skill for RepoQL provides a rigorous framework for technical writing that prioritizes accuracy and purpose. It enforces a strict 'no-harm' policy, operating on the principle that wrong information is worse than missing information. By categorizing content into specific archetypes—such as North-Star visions, Gestalt essences, and agent-optimized references—it ensures that documentation remains maintainable and useful for both human developers and AI agents. This skill is essential for teams who need to establish a single source of truth within their repositories, using audience-scoring and evidence hierarchies to maintain the highest standards of documentation quality.

Key Features

01Standardized metadata frontmatter for searchable and purpose-driven content

02Strict verification hierarchy to eliminate unverified speculation and 'hallucinated' facts

03Archetype-based templates for North-Star, Gestalt, Reference, and Design docs

04Cohesive rewriting workflow to ensure structural integrity after multiple edits

05Audience-scoring system to optimize content for both humans and AI agents

060 GitHub stars

Use Cases

01Creating 'Gestalt' summaries to help developers and AI agents quickly grasp core concepts

02Standardizing architectural design records (ADRs) and implementation plans

03Establishing a 'North Star' vision for complex software features before writing code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add stueeey/repoql.public writing-documents

For use in Claude.ai and ChatGPT

Download Skill