@maestroagora/agora 1.0.0

package/.agents/plugins/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "maestro-agora",
+  "interface": {
+    "displayName": "Maestro: Agora"
+  },
+  "plugins": [
+    {
+      "name": "maestro-agora",
+      "source": {
+        "source": "url",
+        "url": "https://github.com/mbanderas/maestro-agora.git",
+        "ref": "main"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "maestro-agora",
+  "description": "Self-hosted marketplace for the Maestro: Agora marketing skill.",
+  "owner": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "plugins": [
+    {
+      "name": "maestro-agora",
+      "source": "./",
+      "description": "Turn verified product truth into concise, argument-first copy across marketing, sales, editorial, outreach, interface, and spoken channels with the /agora skill."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "maestro-agora",
+  "version": "1.0.0",
+  "displayName": "Maestro: Agora",
+  "description": "Turn verified product truth into concise, argument-first marketing and sales copy across written and spoken channels with the /agora skill.",
+  "author": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "homepage": "https://github.com/mbanderas/maestro-agora",
+  "repository": "https://github.com/mbanderas/maestro-agora",
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "agora",
+    "marketing",
+    "copywriting",
+    "claude-code",
+    "geo",
+    "aeo"
+  ]
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,39 @@
+{
+  "name": "maestro-agora",
+  "version": "1.0.0",
+  "description": "Maestro: Agora turns verified product truth into concise, argument-first copy across written and spoken channels.",
+  "author": {
+    "name": "Mark Laursen",
+    "url": "https://github.com/mbanderas"
+  },
+  "homepage": "https://github.com/mbanderas/maestro-agora#readme",
+  "repository": "https://github.com/mbanderas/maestro-agora",
+  "license": "MIT",
+  "keywords": [
+    "agora",
+    "marketing",
+    "copywriting",
+    "codex",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Maestro: Agora",
+    "shortDescription": "Evidence-led, argument-first copy across every channel",
+    "longDescription": "Install Maestro: Agora in Codex for a direct /agora skill that turns supplied product truth and proof into concise marketing, sales, editorial, outreach, interface, and spoken copy while preserving claim limits.",
+    "developerName": "Mark Laursen",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/mbanderas/maestro-agora",
+    "brandColor": "#7C3AED",
+    "composerIcon": "./assets/icon.png",
+    "defaultPrompt": [
+      "/agora Rewrite this page around one defensible argument and CTA.",
+      "/agora Shorten this copy without losing proof or qualifications.",
+      "/agora Draft a spoken script from the verified facts below."
+    ]
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark Laursen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,136 @@
+<p align="center">
+  <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%" />
+</p>
+
+<h1 align="center">Maestro: Agora</h1>
+
+<p align="center"><strong>Verified truth, conducted into copy.</strong></p>
+
+<p align="center">
+  <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>
+  <a href="https://www.npmjs.com/package/@maestroagora/agora"><img alt="npm version" src="https://img.shields.io/npm/v/@maestroagora/agora" /></a>
+  <a href="LICENSE"><img alt="MIT license" src="https://img.shields.io/badge/license-MIT-7c3aed" /></a>
+</p>
+
+Agora is a portable Agent Skill for marketing, sales, editorial, interface, outreach, and spoken copy. It gives an AI agent a research-backed argument method, a strict claim gate, channel-aware brevity rules, and written GEO/AEO guidance—without treating a persuasive framework as permission to invent the proof.
+
+Give it product truth, evidence, constraints, and one desired action. The skill instructs the agent to return the shortest complete, ready-to-use draft first.
+
+**One suite: fuse the answer, make the case, guard the spend.**
+
+- **[Maestro Frontier](https://github.com/mbanderas/maestro)** — Fuses the model CLIs you already run into one judged, grounded answer.
+- **[Maestro Agora](https://github.com/mbanderas/maestro-agora)** — Turns verified product truth into concise, argument-first copy without inventing the proof.
+- **[Maestro CostGuard](https://github.com/mbanderas/costguard)** — Audits CI and cloud infrastructure for cost leaks and shows what to fix.
+
+## Install
+
+One command installs Agora for the shared Agent Skills path and Claude Code:
+
+```sh
+npx -y @maestroagora/agora
+```
+
+The default user install writes the same reviewed skill to:
+
+- `~/.agents/skills/agora` for Codex and Agent Skills-compatible tools.
+- `~/.claude/skills/agora` for Claude Code.
+
+Choose a native target or project-local scope when you need one:
+
+```sh
+npx -y @maestroagora/agora --target cursor --scope project
+npx -y @maestroagora/agora --target codex,claude --scope user
+npx -y @maestroagora/agora --target universal --dry-run
+```
+
+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.
+
+### Native plugin install
+
+Claude Code:
+
+```text
+/plugin marketplace add mbanderas/maestro-agora
+/plugin install maestro-agora@maestro-agora
+```
+
+Codex CLI:
+
+```sh
+codex plugin marketplace add mbanderas/maestro-agora
+codex plugin add maestro-agora@maestro-agora
+```
+
+The npm installer is the broadest route across IDEs. The native plugin commands install the repository's matching Claude or Codex manifest.
+
+## Use Agora
+
+Invoke the skill directly, then provide the facts it may use:
+
+```text
+/agora Rewrite this upgrade screen. Keep one CTA. Use only these verified facts: ...
+```
+
+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.
+
+Agora activates for writing, rewriting, shortening, critiquing, and planning:
+
+- Marketing and sales copy, CTAs, and microcopy.
+- Landing, product, and comparison pages.
+- Email, direct outreach, ads, and social posts.
+- Mobile onboarding, upgrade, and paywall screens.
+- Editorial content.
+- Audio and video scripts plus titles, descriptions, transcripts, captions, show notes, and companion pages.
+
+## What the skill enforces
+
+Agora silently routes each asset as indexable public, public non-indexable written, private written, spoken-only, or hybrid. It then applies only the controls that fit the surface.
+
+- **Argument before ornament.** Build one defensible belief shift, one decision path, and one primary action.
+- **Proof beside the claim.** Preserve source, scope, date, qualification, and material limitations.
+- **Shortest complete draft.** Remove repetition before evidence, legal meaning, accessibility, or next-step clarity.
+- **Human voice controls.** Cut stock openings, vague hype, fabricated texture, template residue, and decorative recaps.
+- **Claim gate.** Narrow, omit, or flag unsupported claims instead of supplying missing features, prices, routes, urgency, scarcity, testimonials, or results.
+- **Ready copy first.** Return one usable draft without exposing private reasoning or producing near-duplicate variants unless asked.
+
+The skill improves process discipline; it does not replace source review, legal review, or final human verification.
+
+## Written GEO/AEO boundaries
+
+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.
+
+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.
+
+Spoken-only delivery skips GEO/AEO formatting. Published titles, descriptions, transcripts, captions, show notes, and companion pages receive the written treatment separately.
+
+## How Agora works
+
+<p align="center">
+  <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%" />
+</p>
+
+The public skill stays intentionally small:
+
+```text
+skills/agora/
+├── SKILL.md
+├── agents/
+│   └── openai.yaml
+└── references/
+    └── agora-marketing.md
+```
+
+`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.
+
+## Verify the package
+
+```sh
+npm run check
+npx -y @maestroagora/agora --dry-run
+```
+
+The validation suite checks the strict skill root, plugin manifests, relative links, installer behavior, and the exact npm package allowlist.
+
+## License
+
+[MIT](LICENSE)

package/assets/agora-orbit.svg

@@ -0,0 +1,158 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="440" viewBox="0 0 1200 440" role="img" aria-labelledby="title desc">
+  <title id="title">How Maestro Agora works</title>
+  <desc id="desc">An animated gold pen stroke conducts verified truth through argument, proof, voice, and a clear action into ready copy.</desc>
+  <defs>
+    <linearGradient id="background" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#090b19"/>
+      <stop offset="0.52" stop-color="#111630"/>
+      <stop offset="1" stop-color="#07161c"/>
+    </linearGradient>
+    <radialGradient id="core" cx="50%" cy="42%" r="70%">
+      <stop offset="0" stop-color="#8b5cf6" stop-opacity="0.96"/>
+      <stop offset="0.55" stop-color="#5b3ac4" stop-opacity="0.78"/>
+      <stop offset="1" stop-color="#241a56" stop-opacity="0.2"/>
+    </radialGradient>
+    <linearGradient id="signal" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#8b5cf6"/>
+      <stop offset="0.5" stop-color="#22d3ee"/>
+      <stop offset="1" stop-color="#f6b90b"/>
+    </linearGradient>
+    <linearGradient id="penInk" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#fff2ad"/>
+      <stop offset="0.42" stop-color="#f6b90b"/>
+      <stop offset="1" stop-color="#a78bfa"/>
+    </linearGradient>
+    <pattern id="grid" width="36" height="36" patternUnits="userSpaceOnUse">
+      <path d="M 36 0 L 0 0 0 36" fill="none" stroke="#c4b5fd" stroke-opacity="0.055"/>
+    </pattern>
+    <filter id="glow" x="-80%" y="-80%" width="260%" height="260%">
+      <feGaussianBlur stdDeviation="7" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="soft" x="-40%" y="-40%" width="180%" height="180%">
+      <feGaussianBlur stdDeviation="22"/>
+    </filter>
+    <clipPath id="frame">
+      <rect x="1" y="1" width="1198" height="438" rx="28"/>
+    </clipPath>
+    <style>
+      text { font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+      .label { fill: #a5b4d4; font-size: 11px; font-weight: 700; letter-spacing: 2.8px; }
+      .node { fill: #dbeafe; font-size: 12px; font-weight: 750; letter-spacing: 1.7px; }
+      .route { stroke-dasharray: 5 13; animation: route 12s linear infinite; }
+      .orbit { transform-origin: 600px 220px; animation: orbit 34s linear infinite; }
+      .pulse { animation: pulse 3.4s ease-in-out infinite; }
+      .drift { animation: drift 6s ease-in-out infinite; }
+      .signal-dot { animation: shuttle 4.8s ease-in-out infinite; }
+      .pen-stroke { stroke-dasharray: 520; stroke-dashoffset: 520; animation: write 5.8s ease-in-out infinite; }
+      @keyframes route { to { stroke-dashoffset: -180; } }
+      @keyframes orbit { to { transform: rotate(360deg); } }
+      @keyframes pulse { 0%, 100% { opacity: .48; } 50% { opacity: 1; } }
+      @keyframes drift { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(-5px); } }
+      @keyframes shuttle { 0%, 100% { transform: translateX(0); } 50% { transform: translateX(94px); } }
+      @keyframes write { 0%, 12% { stroke-dashoffset: 520; opacity: .3; } 58%, 86% { stroke-dashoffset: 0; opacity: 1; } 100% { stroke-dashoffset: -520; opacity: .3; } }
+      @media (prefers-reduced-motion: reduce) {
+        .route, .orbit, .pulse, .drift, .signal-dot, .pen-stroke { animation: none; stroke-dashoffset: 0; }
+      }
+    </style>
+  </defs>
+
+  <g clip-path="url(#frame)">
+    <rect width="1200" height="440" fill="url(#background)"/>
+    <rect width="1200" height="440" fill="url(#grid)"/>
+    <ellipse cx="280" cy="55" rx="240" ry="145" fill="#7c3aed" opacity="0.12" filter="url(#soft)"/>
+    <ellipse cx="1010" cy="370" rx="270" ry="160" fill="#0ea5a8" opacity="0.13" filter="url(#soft)"/>
+    <path d="M-60 332 C160 204 300 378 485 270 S820 98 1260 210" fill="none" stroke="url(#signal)" stroke-width="1.2" stroke-opacity="0.28" class="route"/>
+    <path d="M-50 358 C180 232 318 395 510 291 S850 129 1250 232" fill="none" stroke="#93c5fd" stroke-width="0.7" stroke-opacity="0.14"/>
+
+    <g transform="translate(58 52)">
+      <rect width="210" height="31" rx="15.5" fill="#11162e" stroke="#7c83a6" stroke-opacity="0.35"/>
+      <circle cx="17" cy="15.5" r="4" fill="#f6b90b" class="pulse"/>
+      <text x="31" y="20" class="label">ARGUMENT-FIRST</text>
+    </g>
+
+    <text x="58" y="138" fill="#f8fafc" font-size="43" font-weight="760" letter-spacing="-1.7">Make the case.</text>
+    <text x="58" y="180" fill="#b8c2dd" font-size="23" font-weight="430">Then make every word earn its place.</text>
+    <text x="58" y="230" fill="#8390af" font-size="14.5">Verified truth in. Concise copy out.</text>
+
+    <g class="drift">
+      <rect x="58" y="285" width="198" height="72" rx="18" fill="#0d1329" stroke="#8b5cf6" stroke-opacity="0.4"/>
+      <text x="78" y="311" class="label">INPUT</text>
+      <text x="78" y="340" fill="#e9e7ff" font-size="16" font-weight="650">REALITY + EVIDENCE</text>
+    </g>
+
+    <path d="M258 321 C342 318 388 284 442 247 C471 228 505 222 535 220" fill="none" stroke="url(#penInk)" stroke-width="3" stroke-linecap="round" class="pen-stroke" filter="url(#glow)"/>
+    <g transform="translate(422 239) rotate(-34)" aria-hidden="true">
+      <path d="M0 0 L30 0 L42 7 L30 14 L0 14 Z" fill="#f6b90b" stroke="#fff2ad" stroke-opacity="0.8"/>
+      <circle cx="31" cy="7" r="2.5" fill="#111630"/>
+    </g>
+
+    <g>
+      <circle cx="600" cy="220" r="128" fill="none" stroke="#9f9bea" stroke-opacity="0.14"/>
+      <circle cx="600" cy="220" r="104" fill="url(#core)" stroke="#a78bfa" stroke-opacity="0.45" filter="url(#glow)"/>
+      <circle cx="600" cy="220" r="82" fill="#11152c" fill-opacity="0.64" stroke="#c4b5fd" stroke-opacity="0.22"/>
+      <text x="600" y="194" text-anchor="middle" class="label">ONE DEFENSIBLE</text>
+      <text x="600" y="231" text-anchor="middle" fill="#ffffff" font-size="28" font-weight="780" letter-spacing="-0.6">BELIEF</text>
+      <text x="600" y="258" text-anchor="middle" fill="#aeb8d3" font-size="12.5">truth · stakes · proof · action</text>
+
+      <g class="orbit">
+        <circle cx="600" cy="92" r="5" fill="#22d3ee" filter="url(#glow)"/>
+        <circle cx="728" cy="220" r="4" fill="#f6b90b"/>
+        <circle cx="600" cy="348" r="4" fill="#a78bfa"/>
+        <circle cx="472" cy="220" r="4" fill="#60a5fa"/>
+      </g>
+
+      <g>
+        <g transform="translate(556 66)">
+          <rect width="88" height="27" rx="13.5" fill="#10172d" stroke="#22d3ee" stroke-opacity="0.4"/>
+          <text x="44" y="18" text-anchor="middle" class="node">ARGUMENT</text>
+        </g>
+        <g transform="translate(704 206)">
+          <rect width="70" height="27" rx="13.5" fill="#10172d" stroke="#f6b90b" stroke-opacity="0.5"/>
+          <text x="35" y="18" text-anchor="middle" class="node">PROOF</text>
+        </g>
+        <g transform="translate(562 347)">
+          <rect width="76" height="27" rx="13.5" fill="#10172d" stroke="#a78bfa" stroke-opacity="0.4"/>
+          <text x="38" y="18" text-anchor="middle" class="node">VOICE</text>
+        </g>
+        <g transform="translate(429 206)">
+          <rect width="66" height="27" rx="13.5" fill="#10172d" stroke="#60a5fa" stroke-opacity="0.4"/>
+          <text x="33" y="18" text-anchor="middle" class="node">CTA</text>
+        </g>
+      </g>
+    </g>
+
+    <path d="M738 220 H884" fill="none" stroke="url(#signal)" stroke-width="2" stroke-linecap="round" class="route"/>
+    <circle cx="764" cy="220" r="4" fill="#22d3ee" class="signal-dot"/>
+
+    <g transform="translate(878 107)">
+      <rect width="264" height="246" rx="24" fill="#0b1422" fill-opacity="0.86" stroke="#f6b90b" stroke-opacity="0.38"/>
+      <rect x="20" y="20" width="92" height="25" rx="12.5" fill="#35290e"/>
+      <text x="66" y="37" text-anchor="middle" fill="#ffd65b" font-size="10.5" font-weight="800" letter-spacing="1.8">OUTPUT</text>
+      <text x="20" y="82" fill="#f8fafc" font-size="23" font-weight="730">Ready copy</text>
+      <text x="20" y="110" fill="#9aa8c4" font-size="13.5">Shortest complete version.</text>
+      <g transform="translate(20 137)">
+        <circle cx="6" cy="6" r="6" fill="#8b5cf6"/>
+        <path d="m3 6 2 2 4-5" fill="none" stroke="#fff" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+        <text x="22" y="11" fill="#cbd5e1" font-size="13">Claim gate</text>
+      </g>
+      <g transform="translate(20 171)">
+        <circle cx="6" cy="6" r="6" fill="#22d3ee"/>
+        <path d="m3 6 2 2 4-5" fill="none" stroke="#07161c" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+        <text x="22" y="11" fill="#cbd5e1" font-size="13">Voice gate</text>
+      </g>
+      <g transform="translate(20 205)">
+        <circle cx="6" cy="6" r="6" fill="#f6b90b"/>
+        <path d="m3 6 2 2 4-5" fill="none" stroke="#07161c" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+        <text x="22" y="11" fill="#cbd5e1" font-size="13">Format router</text>
+      </g>
+    </g>
+
+    <text x="58" y="405" class="label">WRITE  ·  VERIFY  ·  COMPRESS</text>
+    <text x="1142" y="405" text-anchor="end" fill="#f6b90b" font-size="11" font-weight="700" letter-spacing="1.6">MAESTRO · AGORA</text>
+  </g>
+  <rect x="1" y="1" width="1198" height="438" rx="28" fill="none" stroke="#6f78a3" stroke-opacity="0.25"/>
+</svg>

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@maestroagora/agora",
+  "version": "1.0.0",
+  "description": "Install Maestro: Agora, the evidence-led marketing skill for AI coding agents.",
+  "type": "module",
+  "bin": {
+    "agora": "scripts/install.mjs"
+  },
+  "files": [
+    ".agents/plugins/marketplace.json",
+    ".claude-plugin/marketplace.json",
+    ".claude-plugin/plugin.json",
+    ".codex-plugin/plugin.json",
+    "LICENSE",
+    "README.md",
+    "assets/agora-orbit.svg",
+    "assets/icon.png",
+    "assets/maestro-agora-banner.png",
+    "scripts/install.mjs",
+    "skills/agora"
+  ],
+  "scripts": {
+    "check": "npm run validate && npm test && npm run pack:check",
+    "pack:check": "node scripts/pack-check.mjs",
+    "prepublishOnly": "npm run check",
+    "test": "node --test tests/install.test.mjs",
+    "validate": "node scripts/validate.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mbanderas/maestro-agora.git"
+  },
+  "homepage": "https://github.com/mbanderas/maestro-agora#readme",
+  "bugs": {
+    "url": "https://github.com/mbanderas/maestro-agora/issues"
+  },
+  "author": "Mark Laursen",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agent-skills",
+    "maestro",
+    "marketing",
+    "copywriting",
+    "codex",
+    "claude-code",
+    "cursor",
+    "geo",
+    "aeo"
+  ]
+}