write-ws

Create and manage Working Specs with expert audits and serialized role passes.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Dektora/dekspec-public --skill write-ws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-ws
Source: https://github.com/Dektora/dekspec-public/tree/main/plugins/dekspec/skills/write-ws
Command: npx skills add https://github.com/Dektora/dekspec-public --skill write-ws

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude-code, dekspec, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating and maintaining high-quality Working Specs with robust audit and serialized role passes, ensuring clarity, consistency, and compliance in technical documentation.

Core Features & Use Cases

  • Expertise Audit: Conducts a thorough audit of the spec, including template completeness, ADR consistency, domain constraints, failure modes, and expertise audit record.
  • Role Passes: Serializes role passes from various experts, including Writers, ML Experts, Quantization Experts, CUDA Experts, Graph Experts, Embedding Geometers, Pipeline Analysts, Options Architects, and Critics.
  • Lifecycle Management: Supports the full lifecycle of a Working Spec, from creation to lock and unlock, with options for acceptance, revision, and review.

Quick Start

Use the write-ws skill to create a new Working Spec for the salt synthesis pipeline. Provide the description and run the command: /write-ws the salt synthesis pipeline from ingest to mind map node creation

Frequently Asked Questions about write-ws

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

FAQPage Schema
How do I manage technical specification creation with audit and role passes?

You can manage specification creation by generating Working Specs that serialize expert role passes and track template completeness. This process ensures clarity, consistency, and compliance in technical documentation workflows.

What is a serialized role pass in specification management?

Serialized role passes in specification management are sequential expert reviews from roles like Writers, ML Experts, and CUDA Experts. They validate specialized domain constraints to ensure spec quality before document lock.

How do I audit a working spec for compliance and consistency?

Auditing a working spec for compliance involves checking template completeness, ADR consistency, domain constraints, and failure modes. This generates an expertise audit record validating the specification lifecycle.

Do I need Claude Code and dekspec to generate working specs?

Yes, Claude Code and dekspec libraries are required dependencies to generate working specs. They enable the expert-driven specification creation, role pass serialization, and lifecycle management features.

How do I handle the lifecycle of a working spec from creation to lock?

Working spec lifecycle management supports states from creation to lock and unlock, including options for acceptance, revision, and review. This maintains document integrity throughout the specification process.

What are the limitations of using working specs for technical documentation?

Limitations of working specs include the strict dependency on Claude Code and dekspec libraries, restricting usage to supported environments. Additionally, complex multi-expert role passes may introduce serialization overhead.