@maestroagora/agora 1.1.0 → 1.2.0

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.
@@ -1,21 +1,21 @@
1
- {
2
- "name": "maestro-agora",
3
- "interface": {
4
- "displayName": "Maestro: Agora"
5
- },
6
- "plugins": [
7
- {
8
- "name": "maestro-agora",
9
- "source": {
10
- "source": "url",
11
- "url": "https://github.com/mbanderas/maestro-agora.git",
12
- "ref": "main"
13
- },
14
- "policy": {
15
- "installation": "AVAILABLE",
16
- "authentication": "ON_INSTALL"
17
- },
18
- "category": "Productivity"
19
- }
20
- ]
21
- }
1
+ {
2
+ "name": "maestro-agora",
3
+ "interface": {
4
+ "displayName": "Maestro: Agora"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "maestro-agora",
9
+ "source": {
10
+ "source": "url",
11
+ "url": "https://github.com/mbanderas/maestro-agora.git",
12
+ "ref": "main"
13
+ },
14
+ "policy": {
15
+ "installation": "AVAILABLE",
16
+ "authentication": "ON_INSTALL"
17
+ },
18
+ "category": "Productivity"
19
+ }
20
+ ]
21
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "maestro-agora",
3
- "description": "Self-hosted marketplace for Maestro: Agora, the truthful persuasion skill.",
3
+ "description": "Self-hosted marketplace for Maestro: Agora, the argument-first persuasion skill.",
4
4
  "owner": {
5
5
  "name": "Mark Laursen",
6
6
  "url": "https://github.com/mbanderas"
@@ -9,7 +9,7 @@
9
9
  {
10
10
  "name": "maestro-agora",
11
11
  "source": "./",
12
- "description": "Turn verified truth into proof-bounded commercial, editorial, interface, and spoken copy for its real audience and surface."
12
+ "description": "Turn verified facts into consequential commercial, editorial, interface, and spoken arguments for the real decision."
13
13
  }
14
14
  ]
15
15
  }
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "maestro-agora",
3
- "version": "1.1.0",
3
+ "version": "1.2.0",
4
4
  "displayName": "Maestro: Agora",
5
- "description": "Use /agora for truthful buyer, investor, positioning, editorial, interface, and spoken copy that preserves proof limits.",
5
+ "description": "Use /agora for argument-first buyer, investor, positioning, editorial, interface, and spoken copy grounded in verified facts.",
6
6
  "author": {
7
7
  "name": "Mark Laursen",
8
8
  "url": "https://github.com/mbanderas"
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "maestro-agora",
3
- "version": "1.1.0",
4
- "description": "Maestro: Agora writes truthful commercial, editorial, interface, and spoken copy without outrunning the proof.",
3
+ "version": "1.2.0",
4
+ "description": "Maestro: Agora turns verified facts into consequential, channel-native arguments without outrunning the proof.",
5
5
  "author": {
6
6
  "name": "Mark Laursen",
7
7
  "url": "https://github.com/mbanderas"
@@ -19,8 +19,8 @@
19
19
  "skills": "./skills/",
20
20
  "interface": {
21
21
  "displayName": "Maestro: Agora",
22
- "shortDescription": "Truthful arguments for buyers and investors",
23
- "longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that writes proof-bounded buyer, investor, positioning, editorial, interface, and spoken copy for its surface.",
22
+ "shortDescription": "Argument-first copy that earns belief",
23
+ "longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that builds consequential buyer, investor, positioning, editorial, interface, and spoken arguments from verified facts.",
24
24
  "developerName": "Mark Laursen",
25
25
  "category": "Productivity",
26
26
  "capabilities": [
@@ -31,11 +31,9 @@
31
31
  "brandColor": "#7C3AED",
32
32
  "composerIcon": "./assets/icon.png",
33
33
  "defaultPrompt": [
34
- "/agora sell Rewrite this page from one real buyer stake to a defensible belief and one supported action.",
35
- "/agora invest Write an objective investor profile that makes the company mechanism and investment relevance clear.",
36
- "/agora position Turn these verified facts into a proof-bounded company description for this surface.",
37
- "/agora inform Explain this topic from the supplied sources without turning it into a sales pitch.",
38
- "/agora transact Rewrite this confirmation so the state, consequence, and next action are clear."
34
+ "/agora position Turn these facts into a consequential company description. Keep investor relevance implicit.",
35
+ "/agora sell Build the strongest supported buyer argument for this surface, then give one useful next action.",
36
+ "/agora invest Build the capital case from timing, mechanism, proof, and what this round changes."
39
37
  ]
40
38
  }
41
39
  }
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Mark Laursen
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Mark Laursen
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,173 +1,197 @@
1
- <p align="center">
2
- <img src="assets/maestro-agora-banner.png" alt="The Maestro mascot writing with a gold fountain pen as evidence cards become a finished page" width="100%" />
3
- </p>
4
-
5
- <h1 align="center">Maestro: Agora</h1>
6
-
7
- <p align="center"><strong>Verified truth, conducted into copy.</strong></p>
8
-
9
- <p align="center">
10
- <a href="https://github.com/mbanderas/maestro-agora/actions/workflows/validate.yml"><img alt="Validation status" src="https://github.com/mbanderas/maestro-agora/actions/workflows/validate.yml/badge.svg" /></a>
11
- <a href="https://www.npmjs.com/package/@maestroagora/agora"><img alt="npm version" src="https://img.shields.io/npm/v/@maestroagora/agora" /></a>
12
- <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c3aed" /></a>
13
- </p>
14
-
15
- Agora is a portable Agent Skill for truthful persuasion. It turns verified company and product truth into a supported path from a real stake to a defensible belief. The method covers buyer, investor, company-positioning, informational, and transactional copy. It never authorizes a claim the proof cannot carry.
16
-
17
- Give it the real situation, evidence, material limits, and requested surface. Agora returns ready-to-use copy first and puts any material verification need after the draft.
18
-
19
- **Related Maestro tools:**
20
-
21
- - **[Maestro Frontier](https://github.com/mbanderas/maestro):** Fuses the model CLIs you already run into one judged, grounded answer.
22
- - **[Maestro Agora](https://github.com/mbanderas/maestro-agora):** Turns verified truth into proof-bounded arguments for buyers and investors, including objective company positioning.
23
- - **[Maestro CostGuard](https://github.com/mbanderas/costguard):** Audits CI and cloud infrastructure for cost leaks and shows what to fix.
24
-
25
- ## Install
26
-
27
- One command installs Agora for the shared Agent Skills path and Claude Code:
28
-
29
- ```sh
30
- npx -y @maestroagora/agora
31
- ```
32
-
33
- The default user install writes the same reviewed skill to:
34
-
35
- - `~/.agents/skills/agora` for Codex and Agent Skills-compatible tools.
36
- - `~/.claude/skills/agora` for Claude Code.
37
-
38
- Choose a native target or project-local scope when you need one:
39
-
40
- ```sh
41
- npx -y @maestroagora/agora --target cursor --scope project
42
- npx -y @maestroagora/agora --target codex,claude --scope user
43
- npx -y @maestroagora/agora --target universal --dry-run
44
- ```
45
-
46
- Supported targets are `universal`, `shared`, `codex`, `claude`, `cursor`, `gemini`, `copilot`, and `windsurf`. Add `--force` only when you intend to replace a different copy at the exact `agora` destination.
47
-
48
- ### Native plugin install
49
-
50
- Claude Code:
51
-
52
- ```text
53
- /plugin marketplace add mbanderas/maestro-agora
54
- /plugin install maestro-agora@maestro-agora
55
- ```
56
-
57
- Codex CLI:
58
-
59
- ```sh
60
- codex plugin marketplace add mbanderas/maestro-agora
61
- codex plugin add maestro-agora@maestro-agora
62
- ```
63
-
64
- The npm installer is the broadest route across IDEs. The native plugin commands install the repository's matching Claude or Codex manifest.
65
-
66
- ## Use Agora
67
-
68
- Invoke the skill directly, name a mode when you want one, then provide the facts it may use:
69
-
70
- ```text
71
- /agora sell Rewrite this upgrade screen from one real buyer stake to a defensible belief. Keep one supported CTA. Use only these verified facts: ...
72
- ```
73
-
74
- In Codex, `$agora` and the skills picker can also select the installed skill. Other hosts may expose skills through their own picker or mention syntax; asking the agent to "use the agora skill" remains portable.
75
-
76
- ### Commercial modes
77
-
78
- An explicit mode wins. When no mode is named, Agora infers one from the requested asset and the audience's decision.
79
-
80
- | Mode | Use or infer it for |
81
- |---|---|
82
- | `SELL` | Marketing, sales, ads, landing pages, outreach, or paywalls |
83
- | `INVEST` | Investors, funding, pitches, or capital-focused profiles |
84
- | `POSITION` | Company profiles, category narratives, or brand descriptions |
85
- | `INFORM` | Editorial or educational work |
86
- | `TRANSACT` | Buttons, confirmations, alerts, or utility microcopy |
87
-
88
- ### Surface routing
89
-
90
- Mode and surface are separate decisions. An investor description on Crunchbase is `INVEST` on an indexable public, objective profile surface. A paywall is `SELL` on a written interface surface. A published transcript is written even when its source script is spoken.
91
-
92
- | Surface | Treatment |
93
- |---|---|
94
- | `INDEXABLE_PUBLIC` | Public claim review, written human-voice and GEO/AEO gates, plus a technical publication handoff |
95
- | `PUBLIC_NON_INDEXABLE_WRITTEN` | Public claim review, written semantic and evidence rules, plus the human-voice gate; skip crawl and index checks |
96
- | `WRITTEN_PRIVATE` | Proof fidelity, concrete entities, self-contained claims, and the human-voice gate |
97
- | `SPOKEN_ONLY` | Proof review, cadence, breath, timing, and listener comprehension; skip GEO/AEO formatting |
98
- | `HYBRID` | Route every spoken and written derivative separately |
99
-
100
- ### Commercial spine
101
-
102
- For `SELL`, `INVEST`, and `POSITION`, Agora constructs this exact sequence:
103
-
104
- ```text
105
- Recognizable reality -> consequence or opportunity -> new decision criterion -> company or product mechanism -> defensible destination belief -> action or investment relevance.
106
- ```
107
-
108
- Moves may share sentences; none may disappear.
109
-
110
- 1. Recognizable reality. Name the audience's current situation without inventing pain, motive, or urgency.
111
- 2. Consequence or opportunity. Make one truthful stake felt through a concrete business effect, decision risk, or available gain.
112
- 3. New decision criterion. Establish what a credible choice must do, based on the supplied facts.
113
- 4. Company or product mechanism. Explain what changes, what causes the change, and what limits apply.
114
- 5. Defensible destination belief. Land one supported commercial conclusion.
115
- 6. Action or investment relevance. State the logical next step, or why the company merits evaluation when the channel does not permit a CTA.
116
-
117
- ### Objective-channel cap
118
-
119
- On objective platforms such as Crunchbase, the channel caps tone, not argument. Agora keeps the commercial spine factual and compact. It does not replace the stake with hype or force a sales command where investment relevance is the permitted close. If the channel conflicts with the requested commercial job, Agora returns usable copy first and names the conflict afterward.
120
-
121
- ## What the skill enforces
122
-
123
- Agora chooses the commercial job before it formats the surface. Proof review happens before the later formatting and compression passes.
124
-
125
- - Preserve every load-bearing move for `SELL`, `INVEST`, and `POSITION` work before formatting the channel.
126
- - Keep proof beside the claim, with its source, scope, date, qualification, and material limits.
127
- - Use the strongest factual argument an objective channel permits instead of settling for a hollow profile.
128
- - Cut Wikipedia-style flagged vocabulary, connectives, templates, significance tails, generated em dashes, curly quotes, fabricated texture, and decorative recaps.
129
- - Narrow, omit, or flag unsupported claims instead of supplying missing features, prices, routes, urgency, scarcity, testimonials, or results.
130
- - Return one usable draft before assumptions, verification needs, or an objective-channel conflict.
131
- - Remove repetition before cutting a stake, mechanism, proof limit, destination belief, or action relevance.
132
-
133
- The skill improves process discipline; it does not replace source review, legal review, or final human verification.
134
-
135
- ## Written GEO/AEO boundaries
136
-
137
- For written assets, Agora treats generative-engine optimization and answer-engine optimization as clarity and evidence work: answer the reader's question early, name entities and scope, keep proof adjacent to claims, expose provenance, and make useful passages self-contained.
138
-
139
- For indexable public pages, it can also flag technical publication checks such as crawlability, canonical consistency, structured data, and sitemap inclusion. These practices can improve eligibility and citability; they cannot promise retrieval, selection, quotation, citation, ranking, recommendation, referral, conversion, or revenue.
140
-
141
- Spoken-only delivery skips GEO/AEO formatting. Published titles, descriptions, transcripts, captions, show notes, and companion pages receive the written treatment separately.
142
-
143
- ## How Agora works
144
-
145
- <p align="center">
146
- <img src="assets/agora-orbit.svg" alt="Animated flow from verified truth and evidence through argument, proof, voice, and action into ready copy" width="100%" />
147
- </p>
148
-
149
- The public skill stays intentionally small:
150
-
151
- ```text
152
- skills/agora/
153
- ├── SKILL.md
154
- ├── agents/
155
- │ └── openai.yaml
156
- └── references/
157
- └── agora-marketing.md
158
- ```
159
-
160
- `SKILL.md` contains the operating workflow. `references/agora-marketing.md` is the canonical authority for evidence grades, ethical limits, persuasion controls, AI-writing-tell checks, and GEO/AEO boundaries. CiteSurge-specific rules remain isolated to CiteSurge work.
161
-
162
- ## Verify the package
163
-
164
- ```sh
165
- npm run check
166
- npx -y @maestroagora/agora --dry-run
167
- ```
168
-
169
- The validation suite checks the strict skill root, the v1.1.0 behavior contract, plugin metadata, relative links, installer behavior, and the exact npm package allowlist. A committed blind-eval corpus covers mode and surface combinations without calling a model during CI.
170
-
171
- ## License
172
-
173
- [MIT](LICENSE)
1
+ <p align="center">
2
+ <img src="assets/maestro-agora-banner.png" alt="The Maestro mascot writing with a gold fountain pen as evidence cards become a finished page" width="100%" />
3
+ </p>
4
+
5
+ <h1 align="center">Maestro: Agora</h1>
6
+
7
+ <p align="center"><strong>Verified truth, conducted into copy.</strong></p>
8
+
9
+ <p align="center">
10
+ <a href="https://github.com/mbanderas/maestro-agora/actions/workflows/validate.yml"><img alt="Validation status" src="https://github.com/mbanderas/maestro-agora/actions/workflows/validate.yml/badge.svg" /></a>
11
+ <a href="https://www.npmjs.com/package/@maestroagora/agora"><img alt="npm version" src="https://img.shields.io/npm/v/@maestroagora/agora" /></a>
12
+ <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c3aed" /></a>
13
+ </p>
14
+
15
+ Most writing tools start with words. Agora starts with the decision behind them.
16
+
17
+ Give it verified facts, the real audience, and the surface where the copy will live. Agora finds the consequential shift or stake, explains the mechanism that changes it, selects the proof that matters most, and turns that case into channel-native copy. The result can feel urgent, ambitious, reassuring, or direct. It cannot outrun the evidence.
18
+
19
+ Use Agora for landing pages, ads, company profiles, investor narratives, sales email, product copy, paywalls, editorial work, interface text, and spoken scripts.
20
+
21
+ **One suite: fuse the answer, make the case, guard the spend.**
22
+
23
+ - **[Maestro Frontier](https://github.com/mbanderas/maestro):** Fuses the model CLIs you already run into one judged, grounded answer.
24
+ - **[Maestro Agora](https://github.com/mbanderas/maestro-agora):** Turns verified product truth into concise, argument-first copy without inventing the proof.
25
+ - **[Maestro CostGuard](https://github.com/mbanderas/costguard):** Audits CI and cloud infrastructure for cost leaks and shows what to fix.
26
+
27
+ ## Install
28
+
29
+ Install Agora across the shared Agent Skills path and Claude Code:
30
+
31
+ ```sh
32
+ npx -y @maestroagora/agora
33
+ ```
34
+
35
+ The default user install writes the same reviewed skill to:
36
+
37
+ - `~/.agents/skills/agora` for Codex and Agent Skills-compatible tools.
38
+ - `~/.claude/skills/agora` for Claude Code.
39
+
40
+ Choose a target or project-local scope when needed:
41
+
42
+ ```sh
43
+ npx -y @maestroagora/agora --target cursor --scope project
44
+ npx -y @maestroagora/agora --target codex,claude --scope user
45
+ npx -y @maestroagora/agora --target universal --dry-run
46
+ ```
47
+
48
+ Supported targets are `universal`, `shared`, `codex`, `claude`, `cursor`, `gemini`, `copilot`, and `windsurf`. Add `--force` only when you intend to replace a different copy at the exact `agora` destination.
49
+
50
+ Update an existing user installation:
51
+
52
+ ```sh
53
+ npx -y @maestroagora/agora@latest --target universal --scope user --force
54
+ ```
55
+
56
+ ### Native plugin install
57
+
58
+ Claude Code:
59
+
60
+ ```text
61
+ /plugin marketplace add mbanderas/maestro-agora
62
+ /plugin install maestro-agora@maestro-agora
63
+ ```
64
+
65
+ Codex CLI:
66
+
67
+ ```sh
68
+ codex plugin marketplace add mbanderas/maestro-agora
69
+ codex plugin add maestro-agora@maestro-agora
70
+ ```
71
+
72
+ The npm installer is the broadest route across IDEs. Native plugin commands use the matching Claude or Codex manifest from this repository.
73
+
74
+ ## Use Agora
75
+
76
+ Invoke the skill directly and provide the facts it may use:
77
+
78
+ ```text
79
+ /agora Rewrite this upgrade screen. Make the blocked action matter, state the plan difference clearly, and use one supported CTA.
80
+ ```
81
+
82
+ Choose a mode when you want to override inference:
83
+
84
+ ```text
85
+ /agora position Turn these verified facts into a 35-word company profile.
86
+ /agora sell Build a homepage hero around the strongest buyer stake this evidence supports.
87
+ /agora invest Write a one-paragraph capital case from timing, mechanism, proof, and use of funds.
88
+ /agora inform Explain this research finding for a public article.
89
+ /agora transact Rewrite this confirmation so the state and next action are unmistakable.
90
+ ```
91
+
92
+ In Codex, `$agora` and the skills picker can also select the installed skill. Other hosts may expose skills through a picker or mention syntax. Asking the agent to "use the Agora skill" remains portable.
93
+
94
+ ## How the persuasion engine works
95
+
96
+ Agora reasons through a variable-depth path:
97
+
98
+ ```text
99
+ situation -> stake -> criterion when useful -> mechanism -> proof -> destination belief -> next step
100
+ ```
101
+
102
+ That path stays internal. It is not a paragraph template.
103
+
104
+ - Very short copy pairs the strongest market shift, felt stake, or live consequence with the strongest verified differentiator.
105
+ - Medium copy adds the mechanism and the proof clue or qualifier that matters most.
106
+ - Long copy expands only when another fact resolves a real objection or expensive uncertainty.
107
+
108
+ This keeps a 35-word profile from sounding like a compressed pitch deck. It also keeps a full investor narrative from collapsing into a feature list.
109
+
110
+ ### Mode routing
111
+
112
+ | Mode | Use or infer it for |
113
+ |---|---|
114
+ | `POSITION` | Company profiles, directories, About copy, website summaries, category narratives, and objective descriptions |
115
+ | `SELL` | Marketing, sales, ads, landing pages, product pages, outreach, upgrades, and paywalls |
116
+ | `INVEST` | Actual funding, capital-allocation, diligence, investor-pitch, and fundraising work |
117
+ | `INFORM` | Editorial and educational work |
118
+ | `TRANSACT` | Buttons, confirmations, alerts, forms, and utility microcopy |
119
+
120
+ `POSITION` is the default for descriptive company profiles, even when investors may read them. Agora makes relevance emerge from the shift, mechanism, wedge, and proof. It does not insert phrases such as "for investors" or "merits evaluation."
121
+
122
+ ### Proof salience
123
+
124
+ Agora ranks facts by decision relevance, differentiation, verifiability, specificity, compression value, and omission risk.
125
+
126
+ It keeps the facts that change the decision. A measured outcome may outrank five minor features. A named list of supported engines may be the proof when scope is the decision. Diagnostic enumeration stays. Decorative feature volume goes.
127
+
128
+ ### Emotion without invention
129
+
130
+ Agora chooses one dominant emotional job, such as tension, relief, control, ambition, belonging, or curiosity. It expresses that feeling through a real situation, a supportable consequence, and available agency.
131
+
132
+ It never manufactures fear, urgency, scarcity, loss, social proof, intimacy, or certainty. Emotion makes the facts consequential. It does not replace them.
133
+
134
+ ## Surface routing
135
+
136
+ Mode and surface are separate decisions.
137
+
138
+ | Surface | Treatment |
139
+ |---|---|
140
+ | `INDEXABLE_PUBLIC` | Public claim review, human-voice and GEO/AEO passes, then relevant technical publication checks |
141
+ | `PUBLIC_NON_INDEXABLE_WRITTEN` | Public claim review, written evidence structure, and human-voice pass; no crawl or index checks |
142
+ | `WRITTEN_PRIVATE` | Proof fidelity, channel fit, concrete meaning, and human-voice pass |
143
+ | `SPOKEN_ONLY` | Proof review, cadence, breath, timing, and listener comprehension; no GEO/AEO formatting |
144
+ | `HYBRID` | Spoken delivery and each written derivative are routed separately |
145
+
146
+ Published titles, descriptions, transcripts, captions, show notes, and companion pages receive written treatment. Spoken-only delivery stays free of search-format scaffolding.
147
+
148
+ ## Silent safeguards
149
+
150
+ Agora builds the argument before it runs publication and style checks. Those checks remain invisible unless the delivered copy would otherwise be misleading, legally unusable, or operationally unshippable.
151
+
152
+ - Unsupported claims are narrowed or removed, not buried under a disclaimer.
153
+ - Facts, inference, interpretation, aspiration, and promises remain distinct.
154
+ - GEO/AEO improves written clarity and evidence structure after the argument exists.
155
+ - Human-voice cleanup removes prompt leakage, canned templates, generic significance tails, generated em dashes, and smart quotes.
156
+ - Necessary factual series survive the cleanup.
157
+ - One ready-to-use result comes first. Near-duplicate variants appear only when requested.
158
+
159
+ The skill improves writing discipline. It does not replace source review, legal review, or final human judgment.
160
+
161
+ ## Written GEO/AEO boundaries
162
+
163
+ For written assets, Agora answers the reader's question early when the format calls for it, names entities and scope, keeps proof beside claims, exposes real provenance, and builds useful passages that remain accurate when quoted alone.
164
+
165
+ For indexable public pages, Agora can also flag relevant crawlability, canonical, sitemap, metadata, structured-data, accessibility, and delivery checks. These practices can improve eligibility and citability. They cannot promise retrieval, selection, quotation, citation, ranking, recommendation, referral, conversion, or revenue.
166
+
167
+ ## How Agora works
168
+
169
+ <p align="center">
170
+ <img src="assets/agora-orbit.svg" alt="Animated flow from verified truth and evidence through argument, proof, voice, and action into ready copy" width="100%" />
171
+ </p>
172
+
173
+ The skill itself stays intentionally small:
174
+
175
+ ```text
176
+ skills/agora/
177
+ ├── SKILL.md
178
+ ├── agents/
179
+ │ └── openai.yaml
180
+ └── references/
181
+ └── agora-marketing.md
182
+ ```
183
+
184
+ `SKILL.md` is the concise operating contract. `references/agora-marketing.md` holds the original doctrine, research evidence grades, ethical limits, channel rules, AI-writing-tell controls, GEO/AEO boundaries, examples, and evaluation guidance.
185
+
186
+ ## Verify the package
187
+
188
+ ```sh
189
+ npm run check
190
+ npx -y @maestroagora/agora --dry-run
191
+ ```
192
+
193
+ The validation suite checks the strict three-file skill root, the v1.2 behavior contract, plugin metadata, relative links, installer behavior, source-link retention, project-agnostic content, and the exact npm package allowlist. A committed blind-eval corpus covers known failure modes without passing expected answers or grading rules into generation.
194
+
195
+ ## License
196
+
197
+ [MIT](LICENSE)