oh-my-customcode 1.1.31 → 1.1.32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/tracker-checkpoint.md +4 -0
- package/templates/.claude/hooks/hooks.json +1 -1
- package/templates/.claude/ontology/graphs/agent-skill.json +1 -2
- package/templates/.claude/ontology/graphs/full-graph.json +0 -7
- package/templates/.claude/ontology/graphs/skill-rule.json +1 -2
- package/templates/.claude/ontology/skills.yaml +1 -10
- package/templates/.claude/skills/dag-orchestration/SKILL.md +4 -0
- package/templates/.claude/skills/hada-scout/SKILL.md +1 -1
- package/templates/.claude/skills/status/SKILL.md +1 -1
- package/templates/.claude/skills/task-decomposition/SKILL.md +4 -0
- package/templates/CLAUDE.md +1 -1
- package/templates/CLAUDE.md.en +1 -1
- package/templates/CLAUDE.md.ko +1 -1
- package/templates/README.md +2 -2
- package/templates/manifest.json +2 -2
- package/templates/.claude/skills/jinja2-prompts/SKILL.md +0 -86
- package/templates/.claude/skills/peer-messaging/SKILL.md +0 -57
- package/templates/.claude/skills/sdd-development/SKILL.md +0 -24
- package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +0 -66
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
**[한국어 문서 (Korean)](./README_ko.md)**
|
|
15
15
|
|
|
16
|
-
49 agents.
|
|
16
|
+
49 agents. 114 skills. 23 rules. One command.
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
19
|
npm install -g oh-my-customcode && cd your-project && omcustom init
|
|
@@ -132,7 +132,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
132
132
|
|
|
133
133
|
---
|
|
134
134
|
|
|
135
|
-
### Skills (
|
|
135
|
+
### Skills (114)
|
|
136
136
|
|
|
137
137
|
| Category | Count | Includes |
|
|
138
138
|
|----------|-------|----------|
|
|
@@ -144,8 +144,8 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
144
144
|
| Memory | 3 | memory-save, memory-recall, memory-management |
|
|
145
145
|
| Package | 3 | npm-publish, npm-version, npm-audit |
|
|
146
146
|
| Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report |
|
|
147
|
-
| Security |
|
|
148
|
-
| Other |
|
|
147
|
+
| Security | 2 | adversarial-review, cve-triage |
|
|
148
|
+
| Other | 44 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, and ~40 more |
|
|
149
149
|
|
|
150
150
|
Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific).
|
|
151
151
|
|
|
@@ -270,7 +270,7 @@ your-project/
|
|
|
270
270
|
├── CLAUDE.md # Entry point
|
|
271
271
|
├── .claude/
|
|
272
272
|
│ ├── agents/ # 49 agent definitions
|
|
273
|
-
│ ├── skills/ #
|
|
273
|
+
│ ├── skills/ # 114 skill modules
|
|
274
274
|
│ ├── rules/ # 23 governance rules (R000-R023)
|
|
275
275
|
│ ├── hooks/ # 15 lifecycle hook scripts
|
|
276
276
|
│ ├── schemas/ # Tool input validation schemas
|
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -12,6 +12,10 @@ permissionMode: bypassPermissions
|
|
|
12
12
|
|
|
13
13
|
# Tracker Checkpoint Agent
|
|
14
14
|
|
|
15
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
16
|
+
> 이 에이전트는 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
17
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
18
|
+
|
|
15
19
|
## Purpose
|
|
16
20
|
|
|
17
21
|
Pipeline 실행 상태를 persistent checkpoint 파일로 관리. `/pipeline resume`, `dag-orchestration`, `pipeline-guards`와 협력하여 실패 후 재개를 가능하게 합니다.
|
|
@@ -263,7 +263,7 @@
|
|
|
263
263
|
},
|
|
264
264
|
{
|
|
265
265
|
"type": "prompt",
|
|
266
|
-
"prompt": "A background subagent just completed.
|
|
266
|
+
"prompt": "A background subagent just completed. If it FAILED, do NOT auto-continue \u2014 report the failure and wait for user input."
|
|
267
267
|
}
|
|
268
268
|
],
|
|
269
269
|
"description": "Record agent outcomes + auto-continue workflow on subagent completion"
|
|
@@ -354,10 +354,6 @@
|
|
|
354
354
|
"type": "Skill",
|
|
355
355
|
"class": "DeploymentSkill"
|
|
356
356
|
},
|
|
357
|
-
"writing-clearly-and-concisely": {
|
|
358
|
-
"type": "Skill",
|
|
359
|
-
"class": "WritingSkill"
|
|
360
|
-
},
|
|
361
357
|
"web-design-guidelines": {
|
|
362
358
|
"type": "Skill",
|
|
363
359
|
"class": "WritingSkill"
|
|
@@ -1469,9 +1465,6 @@
|
|
|
1469
1465
|
"status": {
|
|
1470
1466
|
"depends_on": []
|
|
1471
1467
|
},
|
|
1472
|
-
"writing-clearly-and-concisely": {
|
|
1473
|
-
"depends_on": []
|
|
1474
|
-
},
|
|
1475
1468
|
"R000": {
|
|
1476
1469
|
"referenced_by": []
|
|
1477
1470
|
},
|
|
@@ -54,7 +54,7 @@ classes:
|
|
|
54
54
|
description: "Deployment automation"
|
|
55
55
|
|
|
56
56
|
WritingSkill:
|
|
57
|
-
skills: [
|
|
57
|
+
skills: [web-design-guidelines]
|
|
58
58
|
description: "Writing quality and UI/UX guidelines"
|
|
59
59
|
|
|
60
60
|
MonitoringSkill:
|
|
@@ -533,12 +533,3 @@ skills:
|
|
|
533
533
|
summary: "UI code review guidelines for accessibility, performance, and UX best practices"
|
|
534
534
|
keywords: [ui, accessibility, ux, performance, design]
|
|
535
535
|
rule_references: []
|
|
536
|
-
|
|
537
|
-
writing-clearly-and-concisely:
|
|
538
|
-
class: WritingSkill
|
|
539
|
-
description: "Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional."
|
|
540
|
-
user_invocable: true
|
|
541
|
-
model_invocable: true
|
|
542
|
-
summary: "Apply Strunk's Elements of Style rules to improve clarity and conciseness in writing"
|
|
543
|
-
keywords: [writing, clarity, conciseness, elements-of-style, strunk]
|
|
544
|
-
rule_references: []
|
|
@@ -8,6 +8,10 @@ user-invocable: false
|
|
|
8
8
|
|
|
9
9
|
# DAG Orchestration Skill
|
|
10
10
|
|
|
11
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
12
|
+
> 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
13
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
14
|
+
|
|
11
15
|
Defines and executes directed acyclic graph (DAG) workflows. The orchestrator uses this skill to plan multi-step tasks with dependencies, execute them in topologically-sorted order, and handle failures.
|
|
12
16
|
|
|
13
17
|
**Orchestrator-only** — only the main conversation uses this skill (R010). Subagents execute individual nodes.
|
|
@@ -50,7 +50,7 @@ The haiku agent receives the following system prompt:
|
|
|
50
50
|
|
|
51
51
|
```
|
|
52
52
|
You are a relevance filter for the oh-my-customcode project — an AI agent harness/orchestration
|
|
53
|
-
system built on Claude Code CLI with 49 agents,
|
|
53
|
+
system built on Claude Code CLI with 49 agents, 114 skills.
|
|
54
54
|
|
|
55
55
|
Project domains (HIGH relevance):
|
|
56
56
|
- AI agent orchestration, multi-agent systems, agent design patterns
|
|
@@ -8,6 +8,10 @@ user-invocable: false
|
|
|
8
8
|
|
|
9
9
|
# Task Decomposition Skill
|
|
10
10
|
|
|
11
|
+
> **Soft-deprecated — 신규 사용 비권장.** 신규 DAG/오케스트레이션 작업은 네이티브 Workflow tool을 우선 사용하십시오. 위상정렬·병렬 팬아웃·재개를 플랫폼이 직접 제공합니다.
|
|
12
|
+
> 이 스킬은 기존 파이프라인 호환을 위해 유지됩니다 — `pipeline auto-dev.yaml`과 `/fsd` 자율 루프가 의존합니다. 삭제 대상이 아니라 신규 사용만 비권장하는 상태입니다.
|
|
13
|
+
> Origin: #1474 (하네스 표면 정리 — 단계적 이행 결정).
|
|
14
|
+
|
|
11
15
|
Analyzes task complexity and decomposes large tasks into smaller, parallelizable subtasks compatible with the DAG orchestration skill. The orchestrator uses this as a planning frontend before execution.
|
|
12
16
|
|
|
13
17
|
## Trigger Conditions
|
package/templates/CLAUDE.md
CHANGED
|
@@ -118,7 +118,7 @@ project/
|
|
|
118
118
|
+-- CLAUDE.md # 진입점
|
|
119
119
|
+-- .claude/
|
|
120
120
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
121
|
-
| +-- skills/ # 스킬 (
|
|
121
|
+
| +-- skills/ # 스킬 (114 디렉토리)
|
|
122
122
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
123
123
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
124
124
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -130,7 +130,7 @@ project/
|
|
|
130
130
|
+-- CLAUDE.md # Entry point
|
|
131
131
|
+-- .claude/
|
|
132
132
|
| +-- agents/ # Subagent definitions (49 files)
|
|
133
|
-
| +-- skills/ # Skills (
|
|
133
|
+
| +-- skills/ # Skills (114 directories)
|
|
134
134
|
| +-- rules/ # Global rules (R000-R023)
|
|
135
135
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
136
136
|
| +-- contexts/ # Context files (ecomode)
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -130,7 +130,7 @@ project/
|
|
|
130
130
|
+-- CLAUDE.md # 진입점
|
|
131
131
|
+-- .claude/
|
|
132
132
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
133
|
-
| +-- skills/ # 스킬 (
|
|
133
|
+
| +-- skills/ # 스킬 (114 디렉토리)
|
|
134
134
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
135
135
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
136
136
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
package/templates/README.md
CHANGED
|
@@ -48,7 +48,7 @@ templates/
|
|
|
48
48
|
├── manifest.json # 배포 컴포넌트 카운트 및 메타데이터
|
|
49
49
|
├── .claude/
|
|
50
50
|
│ ├── agents/ # 에이전트 정의 파일 (*.md, 49개)
|
|
51
|
-
│ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md,
|
|
51
|
+
│ ├── skills/ # 스킬 모듈 (각 디렉토리에 SKILL.md, 114개)
|
|
52
52
|
│ ├── rules/ # 전역 규칙 (R000–R023, 23개)
|
|
53
53
|
│ ├── hooks/
|
|
54
54
|
│ │ ├── hooks.json # 훅 이벤트 설정 (PreToolUse/PostToolUse 등)
|
|
@@ -86,7 +86,7 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
|
|
|
86
86
|
| Manager | 6 |
|
|
87
87
|
| System | 4 |
|
|
88
88
|
|
|
89
|
-
### Skills (
|
|
89
|
+
### Skills (114)
|
|
90
90
|
|
|
91
91
|
`.claude/skills/*/SKILL.md` — 재사용 가능한 스킬 모듈.
|
|
92
92
|
|
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.1.
|
|
2
|
+
"version": "1.1.32",
|
|
3
3
|
"lastUpdated": "2026-07-14T00:00:00.000Z",
|
|
4
4
|
"omcustomMinClaudeCode": "2.1.121",
|
|
5
5
|
"omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"name": "skills",
|
|
21
21
|
"path": ".claude/skills",
|
|
22
22
|
"description": "Reusable skill modules (includes slash commands)",
|
|
23
|
-
"files":
|
|
23
|
+
"files": 114
|
|
24
24
|
},
|
|
25
25
|
{
|
|
26
26
|
"name": "guides",
|
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: jinja2-prompts
|
|
3
|
-
description: Parameterized prompt templates using Jinja2 patterns for reusable, dynamic agent prompts
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Jinja2 Prompt Templates
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
Define reusable, parameterized prompt templates for agent tasks. Templates enable consistent prompt formatting across workflows while allowing dynamic content injection.
|
|
13
|
-
|
|
14
|
-
## Template Syntax
|
|
15
|
-
|
|
16
|
-
Use Jinja2-style variable interpolation in prompt strings:
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
-
{{ variable }} — Variable substitution
|
|
20
|
-
{% if condition %}...{% endif %} — Conditional sections
|
|
21
|
-
{% for item in list %}...{% endfor %} — Iteration
|
|
22
|
-
{{ variable | default("fallback") }} — Default values
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Security Rules
|
|
26
|
-
|
|
27
|
-
- Templates MUST be author-written (stored in skill files), never user-supplied
|
|
28
|
-
- Use `SandboxedEnvironment` (NOT `Environment` or `from_string()` directly)
|
|
29
|
-
- No access to `env()`, `os`, `subprocess`, or any system functions
|
|
30
|
-
- Variable allowlist: only explicitly provided context variables are accessible
|
|
31
|
-
- NEVER render user-controlled strings as templates — treat them as plain data
|
|
32
|
-
|
|
33
|
-
## Template Locations
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
.claude/skills/<skill-name>/templates/
|
|
37
|
-
├── analysis.md.j2
|
|
38
|
-
├── report.md.j2
|
|
39
|
-
└── triage.md.j2
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Usage Pattern
|
|
43
|
-
|
|
44
|
-
```yaml
|
|
45
|
-
# In skill or workflow definition
|
|
46
|
-
template: analysis.md.j2
|
|
47
|
-
variables:
|
|
48
|
-
target: "{{ repository_url }}"
|
|
49
|
-
scope: "security"
|
|
50
|
-
depth: "comprehensive"
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
Rendered by orchestrator before passing to agent as prompt.
|
|
54
|
-
|
|
55
|
-
## Common Templates
|
|
56
|
-
|
|
57
|
-
### Research Team Prompt
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
Role: {{ domain }} {{ role }} analyst
|
|
61
|
-
Scope: {{ topic }}
|
|
62
|
-
|
|
63
|
-
Tasks:
|
|
64
|
-
{% for task in tasks %}
|
|
65
|
-
{{ loop.index }}. {{ task }}
|
|
66
|
-
{% endfor %}
|
|
67
|
-
|
|
68
|
-
Output format:
|
|
69
|
-
{{ output_format }}
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
### CVE Triage Prompt
|
|
73
|
-
|
|
74
|
-
```
|
|
75
|
-
Analyze {{ cve_id }} ({{ cwe_classification }})
|
|
76
|
-
Affected component: {{ component }} {{ version_range }}
|
|
77
|
-
{% if existing_mitigations %}
|
|
78
|
-
Known mitigations: {{ existing_mitigations }}
|
|
79
|
-
{% endif %}
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
## Integration
|
|
83
|
-
|
|
84
|
-
- Used by `/research` skill for team prompt generation
|
|
85
|
-
- Used by `cve-triage` skill for standardized analysis prompts
|
|
86
|
-
- Compatible with DAG orchestration node prompts
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: peer-messaging
|
|
3
|
-
description: Cross-session Claude Code instance messaging via claude-peers-mcp broker
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Peer Messaging Skill
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
Enables cross-session coordination between multiple Claude Code instances through the claude-peers-mcp broker. Complements Agent Teams (R018, intra-session) with inter-session messaging.
|
|
13
|
-
|
|
14
|
-
## Scope Clarification
|
|
15
|
-
|
|
16
|
-
| Scope | Mechanism | Tools | Use Case |
|
|
17
|
-
|-------|-----------|-------|----------|
|
|
18
|
-
| Intra-session agents | Agent Teams (R018) | TeamCreate, SendMessage | Single session multi-agent collaboration |
|
|
19
|
-
| Cross-session instances | claude-peers-mcp | list_peers, send_message | Multi-terminal/project real-time coordination |
|
|
20
|
-
|
|
21
|
-
> **Important**: R018's `SendMessage` and claude-peers-mcp's `send_message` are different tools with different scopes. Do not confuse them.
|
|
22
|
-
|
|
23
|
-
## MCP Tool Mapping
|
|
24
|
-
|
|
25
|
-
| Tool | Purpose | oh-my-customcode Scenario |
|
|
26
|
-
|------|---------|---------------------------|
|
|
27
|
-
| `list_peers` | Discover active Claude instances | `omcustom:status` system overview |
|
|
28
|
-
| `send_message` | Send message to peer | Cross-project workflow coordination |
|
|
29
|
-
| `set_summary` | Broadcast current task summary | DAG cross-project step sync |
|
|
30
|
-
| `check_messages` | Read incoming messages | Receive coordination signals |
|
|
31
|
-
|
|
32
|
-
## Use Cases
|
|
33
|
-
|
|
34
|
-
### Multi-Project Workflow
|
|
35
|
-
Terminal A runs `auto-dev` on project-1; Terminal B works on dependent project-2. Peers coordinate via messages when blocking dependencies are resolved.
|
|
36
|
-
|
|
37
|
-
### Cross-Project QA
|
|
38
|
-
Share test infrastructure state between projects running concurrent test suites.
|
|
39
|
-
|
|
40
|
-
### DAG Bridge
|
|
41
|
-
`dag-orchestration` cross-project steps can use peer messaging for synchronization (currently impossible without this tool).
|
|
42
|
-
|
|
43
|
-
## Setup
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
# Install broker (optional MCP server)
|
|
47
|
-
npm install -g claude-peers-mcp
|
|
48
|
-
|
|
49
|
-
# Add to MCP config
|
|
50
|
-
claude mcp add claude-peers-mcp -- npx claude-peers-mcp
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## Integration
|
|
54
|
-
|
|
55
|
-
- Works with R018 Agent Teams (different scope, complementary)
|
|
56
|
-
- Works with `omcustom:status` (peer discovery)
|
|
57
|
-
- Broker runs on localhost:7899 (SQLite-backed)
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sdd-development
|
|
3
|
-
description: Alias for sdd-dev — Spec-Driven Development workflow
|
|
4
|
-
scope: core
|
|
5
|
-
version: 1.0.0
|
|
6
|
-
user-invocable: true
|
|
7
|
-
argument-hint: "[task description or leave empty for guided workflow]"
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# SDD Development Skill (Alias)
|
|
11
|
-
|
|
12
|
-
This is an alias for the `sdd-dev` skill.
|
|
13
|
-
|
|
14
|
-
**Redirects to**: `.claude/skills/sdd-dev/SKILL.md`
|
|
15
|
-
|
|
16
|
-
See [sdd-dev](../sdd-dev/SKILL.md) for full documentation.
|
|
17
|
-
|
|
18
|
-
## Usage
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
/sdd-development [task description]
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Equivalent to `/sdd-dev [task description]`.
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: writing-clearly-and-concisely
|
|
3
|
-
description: Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.
|
|
4
|
-
scope: core
|
|
5
|
-
user-invocable: false
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# Writing Clearly and Concisely
|
|
9
|
-
|
|
10
|
-
## Overview
|
|
11
|
-
|
|
12
|
-
William Strunk Jr.'s *The Elements of Style* (1918) teaches you to write clearly and cut ruthlessly.
|
|
13
|
-
|
|
14
|
-
**Source**: Internalized from `elements-of-style` plugin (superpowers-marketplace v1.0.0)
|
|
15
|
-
|
|
16
|
-
**WARNING:** The full reference (`templates/guides/elements-of-style/elements-of-style.html`) consumes ~12,000 tokens. Read it only when writing or editing prose.
|
|
17
|
-
|
|
18
|
-
## When to Use This Skill
|
|
19
|
-
|
|
20
|
-
Use this skill whenever you write prose for humans:
|
|
21
|
-
|
|
22
|
-
- Documentation, README files, technical explanations
|
|
23
|
-
- Commit messages, pull request descriptions
|
|
24
|
-
- Error messages, UI copy, help text, comments
|
|
25
|
-
- Reports, summaries, or any explanation
|
|
26
|
-
- Editing to improve clarity
|
|
27
|
-
|
|
28
|
-
**If you're writing sentences for a human to read, use this skill.**
|
|
29
|
-
|
|
30
|
-
## Limited Context Strategy
|
|
31
|
-
|
|
32
|
-
When context is tight:
|
|
33
|
-
1. Write your draft using judgment
|
|
34
|
-
2. Dispatch a subagent with your draft and the reference guide
|
|
35
|
-
3. Have the subagent copyedit and return the revision
|
|
36
|
-
|
|
37
|
-
## All Rules
|
|
38
|
-
|
|
39
|
-
### Elementary Rules of Usage (Grammar/Punctuation)
|
|
40
|
-
1. Form possessive singular by adding 's
|
|
41
|
-
2. Use comma after each term in series except last
|
|
42
|
-
3. Enclose parenthetic expressions between commas
|
|
43
|
-
4. Comma before conjunction introducing co-ordinate clause
|
|
44
|
-
5. Don't join independent clauses by comma
|
|
45
|
-
6. Don't break sentences in two
|
|
46
|
-
7. Participial phrase at beginning refers to grammatical subject
|
|
47
|
-
|
|
48
|
-
### Elementary Principles of Composition
|
|
49
|
-
8. One paragraph per topic
|
|
50
|
-
9. Begin paragraph with topic sentence
|
|
51
|
-
10. **Use active voice**
|
|
52
|
-
11. **Put statements in positive form**
|
|
53
|
-
12. **Use definite, specific, concrete language**
|
|
54
|
-
13. **Omit needless words**
|
|
55
|
-
14. Avoid succession of loose sentences
|
|
56
|
-
15. Express co-ordinate ideas in similar form
|
|
57
|
-
16. **Keep related words together**
|
|
58
|
-
17. Keep to one tense in summaries
|
|
59
|
-
18. **Place emphatic words at end of sentence**
|
|
60
|
-
|
|
61
|
-
### Section V: Words and Expressions Commonly Misused
|
|
62
|
-
Alphabetical reference for usage questions — see `templates/guides/elements-of-style/elements-of-style.html`
|
|
63
|
-
|
|
64
|
-
## Bottom Line
|
|
65
|
-
|
|
66
|
-
Writing for humans? Read the reference guide and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.
|