# danyuchn/asd-ste100-skill architecture

> Architecture diagram of the GitHub repository danyuchn/asd-ste100-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/danyuchn/asd-ste100-skill
- Repository: https://github.com/danyuchn/asd-ste100-skill

## Overview

This repository provides a Claude Code skill that rewrites English for agent-facing use, plus a deterministic structural linter. The main workflow selects strict or STE-flavored mode, analyzes text, rewrites flagged sentences while preserving meaning, and returns the rewrite; users can request a rule-based diff. The README documents these behaviors. The linter excerpt shows some parsing logic, but unsampled code limits detail about its internal rule implementation.

Main entry points: [`SKILL.md`](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md) (STE skill), [`scripts/ste-lint.py`](https://github.com/danyuchn/asd-ste100-skill/blob/master/scripts/ste-lint.py) (Structural checks), [`references/writing-rules.md`](https://github.com/danyuchn/asd-ste100-skill/blob/master/references/writing-rules.md) (Writing rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill["Rewrite skill"]
  node_skill["STE skill<br/>[SKILL.md]"]
  node_mode["Mode selection<br/>[SKILL.md]"]
  node_analysis["Rule analysis<br/>[SKILL.md]"]
  node_rewrite["Sentence rewrite<br/>[SKILL.md]"]
  node_response["Rewrite response<br/>[SKILL.md]"]
  node_diff["Diff explanation<br/>[SKILL.md]"]
end

subgraph group_lint["Structural linter"]
  node_linter["Structural checks<br/>[ste-lint.py]"]
end

subgraph group_guidance["STE guidance"]
  node_rules["Writing rules<br/>[writing-rules.md]"]
  node_examples["Examples<br/>[before-after.md]"]
end

node_requester(("User or agent"))

node_requester -->|"requests rewrite"| node_skill
node_skill -->|"selects mode"| node_mode
node_mode -->|"guides analysis"| node_analysis
node_analysis -->|"flags sentences"| node_rewrite
node_rewrite -->|"returns rewrite"| node_response
node_requester -->|"requests reasoning"| node_diff
node_diff -->|"returns comparison"| node_response
node_requester -->|"runs checks"| node_linter
node_linter -->|"checks patterns"| node_rules

click node_skill "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_mode "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_analysis "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_rewrite "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_response "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_diff "https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md"
click node_linter "https://github.com/danyuchn/asd-ste100-skill/blob/master/scripts/ste-lint.py"
click node_rules "https://github.com/danyuchn/asd-ste100-skill/blob/master/references/writing-rules.md"
click node_examples "https://github.com/danyuchn/asd-ste100-skill/blob/master/examples/before-after.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_mode,node_analysis,node_rewrite,node_response,node_diff,node_requester toneBlue
class node_linter toneAmber
class node_rules,node_examples toneMint
```

## Components

### Rewrite skill

- [STE skill](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`
- [Mode selection](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`
- [Rule analysis](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`
- [Sentence rewrite](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`
- [Rewrite response](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`
- [Diff explanation](https://github.com/danyuchn/asd-ste100-skill/blob/master/SKILL.md): `SKILL.md`

### Structural linter

- [Structural checks](https://github.com/danyuchn/asd-ste100-skill/blob/master/scripts/ste-lint.py): `scripts/ste-lint.py`

### STE guidance

- [Writing rules](https://github.com/danyuchn/asd-ste100-skill/blob/master/references/writing-rules.md): `references/writing-rules.md`
- [Examples](https://github.com/danyuchn/asd-ste100-skill/blob/master/examples/before-after.md): `examples/before-after.md`

### Other components

- **User or agent**

## Connections

- User or agent → STE skill: requests rewrite (evidence: `README.md`)
- STE skill → Mode selection: selects mode (evidence: `README.md`)
- Mode selection → Rule analysis: guides analysis (evidence: `README.md`)
- Rule analysis → Sentence rewrite: flags sentences (evidence: `README.md`)
- Sentence rewrite → Rewrite response: returns rewrite (evidence: `README.md`)
- User or agent → Diff explanation: requests reasoning (evidence: `README.md`)
- Diff explanation → Rewrite response: returns comparison (evidence: `README.md`)
- User or agent → Structural checks: runs checks (evidence: `README.md`)
- Structural checks → Writing rules: checks patterns (evidence: `README.md`)
