coilyco-flight-deck/agentic-os

Watch

Improve the content writing skill(s?) #331

New issue

Closed

opened 2026-07-07 08:10:43 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-07-07 08:10:43 +00:00

Owner

inspo

https://www.reddit.com/r/claudeskills/s/ADlZL59o2r

inspo https://www.reddit.com/r/claudeskills/s/ADlZL59o2r

coilyco-ops added the

autonomy

async-consult

priority

labels

2026-07-07 22:31:47 +00:00

coilyco-ops added

priority

and removed

priority

labels

2026-07-09 21:38:52 +00:00

coilyco-ops commented

2026-07-09 21:41:36 +00:00

Owner

🔎 ward agent advisor

ward agent advisor --harness codex ran a one-shot standard research pass on this question:

Read the issue title, body, and comment thread below as the research brief. Identify the decisions, options, open questions, and risks, then give a clear advisory recommendation that can be posted back on the issue.

The repo does not currently have a general content-writing skill. The existing writing-* surface is fragmented and mostly specialized or defensive:

writing-voice-guide-linter is a style/voice checker.
writing-observer-narrator is one persona archetype.
writing-public-repos is a public-safety guardrail.
writing-refactor-plan and writing-to-issues are issue-writing workflows.
writing-system-improvement-vocab is terminology, not a drafting aid.

That matters because the Reddit inspo is not really asking for "better prose" in the abstract. It is proposing a three-part writing system:

Explicit voice modeling instead of one generic "humanizer" style.
A linter/auditor that catches AI tells and repetitive structure.
A verify-revise loop where the writer and the judge are separated.

Relevant sources:

Reddit inspo: r/claudeskills post
Example implementation the post points to: nagisanzenin/idiolect
Current repo conventions: .agents/skills/tooling-skill-authoring/SKILL.md, docs/skill-discipline-authoring.md, docs/skill-discipline-handbook*.md

What Seems Worth Taking

The strongest idea from the inspo is not "make AI text look more human." It is "stop collapsing every draft into the same clean, generic house voice." That maps well to this repo's skill philosophy.

The part worth importing into agentic-os is:

Voice as parameters/constraints, not vague adjectives.
Checks for structure drift and repeated AI habits, not just word blacklist removal.
A drafting workflow that keeps authorial intent explicit: audience, channel, stance, examples, anti-patterns.
An auditing pass that is advisory and local, not a magical detector.

What Does Not Seem Like a Good Fit

A large public roster of fictional personas, especially ones meant to pass as unrelated real people, looks like the wrong center of gravity for this repo.

Risks:

It drifts from "help Kai write clearly and consistently" into "help an agent imitate strangers."
It creates ongoing maintenance burden. Voice profiles rot quickly.
It weakens the repo's public-safe posture if the skill starts reading as a sockpuppet toolkit.
It bloats agentic-os with content assets when this repo is mainly a skill and tooling source.

Decisions To Make

One skill or several?
My read: several small composable skills are a better fit than one giant "content writing" skill.
Authentic voice vs impersonation?
The repo should optimize for authentic authorial control, not deception.
Deterministic linter only, or LLM auditor too?
Deterministic lint is the safer first step. A semantic auditor can follow later if it has a clearly bounded contract.
Public or private voice profiles?
General writing mechanics belong here. Kai-specific or high-context voice profiles likely belong in a private overlay, not public agentic-os.

Recommended Shape

Recommend treating this as single-repo work in agentic-os, with a small writing-skill expansion rather than a cross-repo initiative.

1. Add a new general writing skill

Create a new writing-* skill that covers content drafting and revision, not issue-splitting or persona lore.

Suggested scope:

inputs: audience, channel, goal, stance, constraints, examples to imitate, examples to avoid
process: extract voice constraints, draft, self-critique, revise
checks: specificity, stakes, structure repetition, generic transitions, wrap-up boilerplate, symmetrical enthusiasm
outputs: draft plus a short receipt explaining what constraints were applied

This fills the obvious gap in the current surface.

2. Extend the existing linter story instead of replacing it

writing-voice-guide-linter is the natural seed for a second layer.

Recommendation:

keep the current rule-based voice checks
add an optional AI-tell/advice mode for common structural tells
position it as a draft linter, not a truth machine or detector of other people's writing

That matches the strongest part of the inspo without overclaiming.

3. Keep voice/persona modeling narrow and explicit

If voice profiles are added at all, start with a tiny set of legitimate authorial modes, not dozens of fictional people.

Examples of acceptable shapes:

terse operator update
public project announcement
technical explainer for peers
reflective postmortem note

Those are writing modes, not fake identities.

4. Preserve the repo's existing doctrine

Any new skill should inherit the repo's existing rules:

explain the why, not just the procedure
keep skills composable and flat
avoid promising automation beyond drafting/auditing
stay public-safe

Open Questions

Is the desired outcome "help Kai write in her own voice" or "offer multiple reusable voices"?
Should the first version focus on short-form posts only, or also README / issue / blog drafting?
Is an LLM-based semantic auditor acceptable in this repo, or should v1 stay deterministic?
Should Kai-specific voice guidance stay public here, or live in a private overlay skill?

Advisory Recommendation

Recommend not building a public "humanizer" or large fictional-persona pack in agentic-os.

Recommend yes on improving the writing surface by adding:

a new general writing-* drafting skill,
a stronger lint/audit pass layered onto writing-voice-guide-linter, and
a small, explicit set of authentic writing modes instead of impersonation-oriented personas.

That captures the useful insight from the inspo while keeping the repo aligned with its current role and safety posture.

Researched and posted automatically by ward agent advisor --harness codex (ward#179). This is one-shot research, not a carried change - verify before acting on it.

— Codex, via ward agent

### 🔎 ward agent advisor `ward agent advisor --harness codex` ran a one-shot **standard** research pass on this question: > Read the issue title, body, and comment thread below as the research brief. Identify the decisions, options, open questions, and risks, then give a clear advisory recommendation that can be posted back on the issue. --- The repo does **not** currently have a general content-writing skill. The existing `writing-*` surface is fragmented and mostly specialized or defensive: - `writing-voice-guide-linter` is a style/voice checker. - `writing-observer-narrator` is one persona archetype. - `writing-public-repos` is a public-safety guardrail. - `writing-refactor-plan` and `writing-to-issues` are issue-writing workflows. - `writing-system-improvement-vocab` is terminology, not a drafting aid. That matters because the Reddit inspo is not really asking for "better prose" in the abstract. It is proposing a **three-part writing system**: 1. **Explicit voice modeling** instead of one generic "humanizer" style. 2. **A linter/auditor** that catches AI tells and repetitive structure. 3. **A verify-revise loop** where the writer and the judge are separated. Relevant sources: - Reddit inspo: [r/claudeskills post](https://www.reddit.com/r/claudeskills/s/ADlZL59o2r) - Example implementation the post points to: [nagisanzenin/idiolect](https://github.com/nagisanzenin/idiolect) - Current repo conventions: `.agents/skills/tooling-skill-authoring/SKILL.md`, `docs/skill-discipline-authoring.md`, `docs/skill-discipline-handbook*.md` ## What Seems Worth Taking The strongest idea from the inspo is **not** "make AI text look more human." It is "stop collapsing every draft into the same clean, generic house voice." That maps well to this repo's skill philosophy. The part worth importing into `agentic-os` is: - **Voice as parameters/constraints**, not vague adjectives. - **Checks for structure drift and repeated AI habits**, not just word blacklist removal. - **A drafting workflow that keeps authorial intent explicit**: audience, channel, stance, examples, anti-patterns. - **An auditing pass** that is advisory and local, not a magical detector. ## What Does Not Seem Like a Good Fit A large public roster of fictional personas, especially ones meant to pass as unrelated real people, looks like the wrong center of gravity for this repo. Risks: - It drifts from "help Kai write clearly and consistently" into "help an agent imitate strangers." - It creates ongoing maintenance burden. Voice profiles rot quickly. - It weakens the repo's public-safe posture if the skill starts reading as a sockpuppet toolkit. - It bloats `agentic-os` with content assets when this repo is mainly a skill and tooling source. ## Decisions To Make 1. **One skill or several?** My read: several small composable skills are a better fit than one giant "content writing" skill. 2. **Authentic voice vs impersonation?** The repo should optimize for authentic authorial control, not deception. 3. **Deterministic linter only, or LLM auditor too?** Deterministic lint is the safer first step. A semantic auditor can follow later if it has a clearly bounded contract. 4. **Public or private voice profiles?** General writing mechanics belong here. Kai-specific or high-context voice profiles likely belong in a private overlay, not public `agentic-os`. ## Recommended Shape Recommend treating this as **single-repo work in `agentic-os`**, with a small writing-skill expansion rather than a cross-repo initiative. ### 1. Add a new general writing skill Create a new `writing-*` skill that covers **content drafting and revision**, not issue-splitting or persona lore. Suggested scope: - inputs: audience, channel, goal, stance, constraints, examples to imitate, examples to avoid - process: extract voice constraints, draft, self-critique, revise - checks: specificity, stakes, structure repetition, generic transitions, wrap-up boilerplate, symmetrical enthusiasm - outputs: draft plus a short receipt explaining what constraints were applied This fills the obvious gap in the current surface. ### 2. Extend the existing linter story instead of replacing it `writing-voice-guide-linter` is the natural seed for a second layer. Recommendation: - keep the current rule-based voice checks - add an **optional AI-tell/advice mode** for common structural tells - position it as a **draft linter**, not a truth machine or detector of other people's writing That matches the strongest part of the inspo without overclaiming. ### 3. Keep voice/persona modeling narrow and explicit If voice profiles are added at all, start with a tiny set of **legitimate authorial modes**, not dozens of fictional people. Examples of acceptable shapes: - terse operator update - public project announcement - technical explainer for peers - reflective postmortem note Those are writing modes, not fake identities. ### 4. Preserve the repo's existing doctrine Any new skill should inherit the repo's existing rules: - explain the **why**, not just the procedure - keep skills composable and flat - avoid promising automation beyond drafting/auditing - stay public-safe ## Open Questions - Is the desired outcome "help Kai write in her own voice" or "offer multiple reusable voices"? - Should the first version focus on short-form posts only, or also README / issue / blog drafting? - Is an LLM-based semantic auditor acceptable in this repo, or should v1 stay deterministic? - Should Kai-specific voice guidance stay public here, or live in a private overlay skill? ## Advisory Recommendation Recommend **not** building a public "humanizer" or large fictional-persona pack in `agentic-os`. Recommend **yes** on improving the writing surface by adding: 1. a new general `writing-*` drafting skill, 2. a stronger lint/audit pass layered onto `writing-voice-guide-linter`, and 3. a small, explicit set of authentic writing modes instead of impersonation-oriented personas. That captures the useful insight from the inspo while keeping the repo aligned with its current role and safety posture. --- Researched and posted automatically by `ward agent advisor --harness codex` (ward#179). This is one-shot research, not a carried change - verify before acting on it.   — Codex, via `ward agent`

coilysiren referenced this issue from coilyco-flight-deck/ward

2026-07-10 04:03:12 +00:00

ward release race condition #935

coilysiren referenced this issue from coilyco-flight-deck/ward

2026-07-14 15:27:09 +00:00

director should emit colorized, space buffered, visually distinct messages about the categories of actions its performing on startup #1283

coilyco-ops closed this issue

2026-07-29 05:57:06 +00:00