co-creation-docs

Routes docs-only changes to direct push, pull request, or regular development based on risk classification.

2.9k|733|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/zts212653/clowder-ai --skill co-creation-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: co-creation-docs
Source: https://github.com/zts212653/clowder-ai/tree/main/cat-cafe-skills/co-creation-docs
Command: npx skills add https://github.com/zts212653/clowder-ai --skill co-creation-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents documentation-only changes from being forced through heavyweight code-level pipelines (worktrees, cloud review, full gates) while still catching governance, conflict, and irreversibility risks that genuinely require escalation.

Core Features & Use Cases

  • Intent Gating: Distinguishes review-only requests from authorized co-creation and landing, blocking writes, commits, and pushes when only feedback was requested.
  • Risk-Based Classification: Runs a classifier with explicit conflict and reversibility inputs to decide between direct push, pull request, or regular development lanes.
  • Independent Escalation Decisions: Treats PR creation, cloud review, and full gate as three separate conclusions rather than an automatic bundle.
  • Use Case: When updating a long architecture document in docs/ with no conflicting PRs and a single reversible commit, the skill self-assesses direct push, runs lightweight incremental frontmatter validation, commits with a Why-focused message, and reports the SHA and push result.

Quick Start

Ask the assistant to review and land these Markdown documentation changes using the co-creation docs lane, classifying the risk before deciding between direct push and a pull request.

Frequently Asked Questions about co-creation-docs

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

FAQPage Schema
How do I decide between direct push and a pull request for docs changes?

Direct push applies when changed files are plain docs-only content, no governance or execution surfaces are touched, no conflicts are known, and the change is reversible in one commit. Otherwise run the classifier with explicit conflict and reversibility inputs to decide.

What triggers a docs-only change to require a pull request?

A PR is required when the classifier detects path conflicts with in-flight work, unknown reversibility, or governance risk such as edits to SOP definitions. Conflict signals or uncertainty should always escalate away from direct push.

Does a docs pull request automatically trigger cloud review and full gate?

No. PR creation, cloud review, and full gate are three independent decisions. Cloud review and full gate only apply when code, tests, security boundaries, or external contracts are involved, not for ordinary documentation.

When should changes to SKILL.md or scripts avoid the docs lane?

Edits to SKILL.md files, scripts, SOP definitions, or any first-party execution surface must route to regular development risk routing, not the docs lane. Being Markdown-formatted does not make a governance file a plain document.

Why is running full validation on every docs change discouraged?

Running full gates, worktrees, or generator-level checks on plain docs imposes code-level process cost without added safety. Lightweight incremental frontmatter validation is sufficient for ordinary content changes.