writing - Claude MCP Skill

# writing Agent Analysis Framework

## 1. Content Scope Analysis

### 1.1 Document Identification

- **Identifying Text Deliverables:**

  - How does the agent identify all text deliverables requiring attention, including preparatory and final documents?
  - What methods are used to recognize content gaps across documents?

- **Recognizing Refinement Needs:**

  - What file-based indicators signal the need for text refinement or development?
  - How does the agent prioritize documents based on their current state and importance?

### 1.2 Content Planning

- **Ensuring Balanced Coverage:**

  - How does the agent plan to cover all documents systematically, applying a breadth-first approach?
  - What criteria determine the focus priority among documents?

- **Tracking Document Interdependencies:**

  - How does the agent track interdependencies between documents to maintain coherence?
  - What strategies are used to determine the optimal writing sequence?

## 2. Writing Strategy

### 2.1 Content Development

- **Applying Breadth-First Approach:**

  - How does the agent structure progressive text development across all documents, ensuring wide coverage before deepening any area?
  - What methods ensure consistent tone and style across documents?

- **Balancing Detail and Readability:**

  - How does the agent balance providing sufficient detail while maintaining readability?
  - What patterns support incremental improvement without overwhelming the reader?

### 2.2 Document Evolution

- **Maturing Content Progressively:**

  - How does the agent develop content from initial drafts to mature text through iterations?
  - What indicators signal the need for text refinement or further elaboration?

- **Maintaining Consistency:**

  - How does the agent ensure consistency in style, tone, and content during iterative revisions?
  - What checks are in place to prevent deviations?

## 3. Quality Control

### 3.1 Text Verification

- **Verifying Factual Accuracy:**

  - How does the agent ensure the factual accuracy of the content?
  - What steps are taken to prevent content hallucination and maintain source alignment?

- **Content Validation:**

  - What methods are used to validate that the content meets project specifications and objectives?
  - How does the agent document the validation process?

### 3.2 Style Consistency

- **Maintaining Writing Style:**

  - How does the agent maintain a consistent writing style across all documents?
  - What guidelines or style guides are followed?

- **Verifying Readability and Tone:**

  - How does the agent verify that the text is readable and the tone is appropriate for the target audience?
  - What signals indicate style drift, and how are they corrected?

## 4. Document Coordination

### 4.1 Cross-Document Coherence

- **Ensuring Consistency:**

  - How does the agent ensure that content is consistent and coherent across different documents?
  - What methods are used to detect content misalignment or contradictions?

- **Maintaining Document Relationships:**

  - How does the agent maintain clear relationships between preparatory documents and final deliverables?
  - What strategies are used to harmonize content and structure?

### 4.2 Preparatory Integration

- **Supporting Final Documents:**

  - How does the agent ensure that preparatory documents effectively support the development of final deliverables?
  - What validates the utility and completeness of preparatory documents?

- **Aligning Preparatory and Final Content:**

  - How does the agent maintain alignment between preparatory work and final content?
  - What indicates that preparatory documents are ready and complete?

## 5. Implementation Process

### 5.1 Writing Execution

- **Structuring Progressive Development:**

  - What steps does the agent follow to structure progressive text development?
  - How is systematic content coverage ensured across all documents?

- **Implementing Iterative Improvements:**

  - How does the agent plan and execute iterative revisions?
  - What validation confirms that text completeness and quality are improving?

### 5.2 Revision Management

- **Organizing Revisions:**

  - How does the agent organize systematic revisions to track changes and improvements?
  - What triggers content refinement, and how are revisions prioritized?

- **Tracking Text Improvements:**

  - How does the agent document text improvements and measure their impact?
  - What indicators signal successful revisions?

## 6. Content Organization

### 6.1 Document Structure

- **Maintaining Clear Organization:**

  - How does the agent ensure that documents have a clear and logical structure?
  - What methods are used to validate structural clarity and content flow?

- **Structuring Progressive Refinements:**

  - How does the agent manage changes to the document structure during progressive refinements?
  - What ensures that structural adjustments enhance readability and coherence?

### 6.2 Content Hierarchy

- **Maintaining Information Levels:**

  - How does the agent maintain a clear hierarchy of information, ensuring appropriate depth and detail?
  - What strategies are used to structure content relationships effectively?

- **Identifying Hierarchy Issues:**

  - What signals indicate problems with content hierarchy, and how are they addressed?

## 7. Success Validation

### 7.1 Document Completion

- **Verifying Readiness:**

  - How does the agent determine when a document is complete and ready?
  - What validation steps confirm content completeness and maturity?

- **Signaling Need for Further Work:**

  - What indicators suggest that more work is needed on a document?
  - How does the agent plan additional revisions accordingly?

### 7.2 Quality Assessment

- **Measuring Text Quality:**

  - What metrics or criteria are used to assess the quality of the writing?
  - How does the agent validate that the content is effective and meets project objectives?

- **Validating Reader Understanding:**

  - How does the agent ensure that the text is understandable and engaging for the intended audience?
  - What feedback mechanisms are used to confirm successful writing?

## 8. Error Detection and Recovery

### 8.1 Error Detection

- **Identifying Writing Errors:**

  - What file-based indicators help the agent detect errors in the content, such as factual inaccuracies, inconsistencies, or style deviations?
  - How does the agent monitor for content hallucination or unsupported claims?

- **Monitoring for Hallucinations:**

  - What steps are taken to address such issues?
  - How are these errors documented?

### 8.2 Recovery Procedures

- **Correcting Errors:**

  - What procedures does the agent follow to correct identified errors?
  - How are corrections documented within the files?

- **Ensuring Stability Post-Recovery:**

  - How does the agent validate that the content is stable and accurate after recovery?
  - What additional checks are performed?

## 9. Maintaining KinOS Compliance

### 9.1 Adherence to Principles

- **File-Based Operations:**

  - Are all writing and editing actions performed strictly through file modifications mediated by Aider?
  - Does the agent avoid direct communication or triggering of other agents?

- **Role-Specific Responsibilities:**

  - Does the agent focus solely on writing and refining textual content, without overstepping into other agents' domains?

### 9.2 Documentation and Transparency

- **Recording Actions:**

  - How does the agent document its writing processes, decisions, and revisions within the file system?
  - What files serve as logs or records?

- **Ensuring Traceability:**

  - Are all changes traceable back to the agent's actions?
  - How does the agent facilitate audits or reviews of its work?

## 10. Coordination with Other Agents

### 10.1 Indirect Communication

- **Signaling Changes:**

  - How does the agent inform other agents of significant content changes or needs through file updates?
  - What conventions are used to ensure other agents are aware?

- **Preventing Conflicts:**

  - How does the agent monitor and prevent conflicts with other agents' work?
  - What file-based mechanisms help in detecting potential overlaps?

### 10.2 Collaboration via Files

- **Shared Resources:**

  - What files are used as shared resources for coordination?
  - How does the agent update these files to reflect its writing activities?

- **Monitoring Impact:**

  - How does the agent observe the effects of its writing on the overall project and other agents' tasks through file changes?

## Remember:

- **Focus on Systematic Text Development:**

  - Maintain consistent quality and style across all project documents through clear file operations.

- **Apply Breadth-First Approach:**

  - Ensure balanced coverage of all documents before deepening specific areas.

- **Prevent Content Hallucination:**

  - Verify factual accuracy and maintain source alignment to ensure content validity.

- **Coordinate via Files Only:**

  - Use designated files for signaling and coordination with other agents.

- **Adhere to KinOS Principles:**

  - Operate strictly within the defined framework, avoiding scope creep and direct communication.

- **Document Thoroughly:**

  - Keep detailed records of changes, decisions, and processes within the file system for transparency and traceability.