anymorph 0.2.2 → 0.2.3

package/dist/skillpacks/geo/skills/geo-writer/references/seo-geo-insights.md

@@ -0,0 +1,269 @@
+# SEO/GEO Insight Reference
+
+Canonical source distilled from:
+
+- `/Users/tachyon/brain/01-Projects/Content/SEO GEO insight/SEO GEO 실행 원칙.md`
+- `/Users/tachyon/brain/01-Projects/Content/SEO GEO insight/SEO GEO 콘텐츠 원칙.md`
+
+This reference is the operating law for `geo-writer`. Apply it before drafting, briefing, or calling page generation.
+
+## Core Thesis
+
+SEO/GEO는 검색어를 노리는 일이 아니라 **발견되고, 이해되고, 신뢰되고, 선택되는 답변 자산을 운영하는 일**이다.
+
+SEO 콘텐츠는 검색 결과에서 선택될 페이지여야 한다. GEO 콘텐츠는 AI 답변 안에 합성될 근거여야 한다. 공통 기준은 `intent`, `answer`, `evidence`, `entity`, `trust`, `conversion`을 모두 갖추는 것이다.
+
+| Dimension | SEO | GEO |
+| --- | --- | --- |
+| Competition surface | 검색 결과 화면 | AI 답변 내부 |
+| Core unit | keyword, URL, SERP | prompt, entity, source, answer |
+| Success signal | ranking, CTR, click, conversion | mention, citation, framing, AI share of voice |
+| Main asset | 검색 의도에 맞는 페이지 | AI가 인용 가능한 근거 자산 |
+| Execution goal | 검색 결과에서 선택될 페이지 만들기 | AI 답변 안에 들어갈 신뢰 source 만들기 |
+
+SEO는 `page selection` 문제다. 검색엔진이 특정 문제를 가진 사람에게 페이지를 발견, 이해, 신뢰, 선택하게 만드는 것이다.
+
+GEO는 `answer inclusion` 문제다. AI가 답변을 합성할 때 브랜드, 콘텐츠, 데이터, 관점을 신뢰 가능한 근거로 선택하고 올바른 맥락으로 재서술하게 만드는 것이다.
+
+## Execution Layers
+
+| Layer | SEO job | GEO job |
+| --- | --- | --- |
+| Accessibility | Googlebot/Bingbot이 crawl/index 가능하게 한다 | OAI-SearchBot, PerplexityBot, Bingbot, Googlebot 접근 정책을 점검한다 |
+| Discovery | sitemap, internal links, external links로 URL 발견성을 확보한다 | IndexNow, crawler allow, source feed, third-party surface를 관리한다 |
+| Understanding | title, heading, schema, canonical, topic cluster를 정리한다 | entity, brand, product, category, competitor 관계를 일관되게 정의한다 |
+| Content | search intent를 만족하는 페이지를 만든다 | AI가 답변에 바로 쓸 수 있는 answer block과 evidence block을 만든다 |
+| Trust | author, source, date, methodology, backlinks를 확보한다 | 독자적 데이터, benchmark, 고객 사례, 외부 검증 source를 확보한다 |
+| Selection | SERP에서 클릭받을 title/meta/format을 최적화한다 | 답변 내 mention, citation, framing, response position을 최적화한다 |
+| Measurement | impressions, clicks, CTR, position, conversion을 본다 | prompt coverage, citation share, AI share of voice, framing accuracy를 본다 |
+
+Important content must be accessible as HTML/text. If crawlers cannot read it, SEO/GEO cannot select it as a candidate.
+
+## Common Operating Principles
+
+| Principle | Why it matters | Measurement |
+| --- | --- | --- |
+| Open crawler access | 접근 불가하면 후보에 못 들어간다 | indexed pages, crawl errors, crawler logs |
+| Link important URLs internally and in sitemaps | 발견되지 않는 페이지는 평가되지 않는다 | discovered/indexed URL ratio |
+| Clean canonical and duplicates | 대표 URL 신호 분산은 신뢰를 약화한다 | canonical status, duplicate warnings |
+| One URL, one primary intent | 의도가 섞이면 선택 확률이 낮아진다 | query-page match, engagement |
+| Add unique POV, data, or experience | generic content has no citation value | backlinks, citations, branded mentions |
+| Attach evidence to claims | users and AI trust evidence over assertions | citation frequency, source quality |
+| Make trust signals visible | who/how/why/source/method matter | author/source/methodology coverage |
+| Preserve page experience | slow or obstructive pages reduce satisfaction | Core Web Vitals, UX metrics |
+| Avoid spam optimization | keyword stuffing, schemes, scaled AI content create long-term risk | manual actions, ranking drops |
+
+## SEO-Specific Principles
+
+| Principle | Rule |
+| --- | --- |
+| Search intent first | keyword보다 실제 의도와 검색 결과의 기대 형식을 분석한다 |
+| SERP format fit | guide, list, comparison, product page, calculator 등 현재 SERP가 원하는 형식에 맞춘다 |
+| Bottom-funnel priority | B2B에서는 alternatives, vs, pricing, integration page를 우선 만든다 |
+| Internal authority flow | hub/spoke 구조와 anchor text로 중요한 페이지에 발견성과 권위를 전달한다 |
+| Link-worthy asset | 외부에서 인용할 만한 원본 데이터, 도구, 표, 분석을 만든다 |
+
+## GEO-Specific Principles
+
+| Principle | Rule |
+| --- | --- |
+| Prompt set first | keyword가 아니라 ICP가 AI에게 던질 target prompt set을 정의한다 |
+| Answer block | heading 직후 direct answer를 둔다 |
+| Fan-out coverage | 원 질문에서 파생되는 하위 질문까지 커버한다 |
+| Entity consistency | 브랜드, 제품, 카테고리, 경쟁사 대비 포지션을 일관되게 정의한다 |
+| Third-party corroboration | first-party 주장과 외부 검증 source가 충돌하지 않게 한다 |
+| Framing control | AI가 브랜드를 어떤 맥락으로 설명하는지 추적하고 교정한다 |
+| AI visibility measurement | GSC만 보지 말고 prompt coverage, citation share, AI share of voice를 별도로 본다 |
+| Influence tracking | click/referral뿐 아니라 AI 답변이 구매 판단에 미치는 영향도 본다 |
+
+GEO 콘텐츠는 AI가 문단 하나, 표 하나, 정의 하나만 떼어가도 의미가 유지되어야 한다.
+
+## Content Quality Criteria
+
+| Criterion | Standard |
+| --- | --- |
+| Intent-first | 검색어가 아니라 buyer의 실제 질문과 prompt intent에 맞아야 한다 |
+| Answer-first | 핵심 답을 초반에 바로 줘야 한다 |
+| Evidence-dense | 주장마다 근거, 숫자, 사례, 출처가 있어야 한다 |
+| Non-commodity | 누구나 쓸 수 있는 일반론이 아니어야 한다 |
+| Entity-clear | 브랜드, 제품, 카테고리, 경쟁사, 사용 사례가 명확해야 한다 |
+| Focused | 한 페이지는 한 primary topic/intent에 집중해야 한다 |
+| Complete | 사용자가 다시 검색하지 않아도 될 만큼 충분해야 한다 |
+| Citable | 문장, 표, 정의, 데이터가 인용 가능한 단위여야 한다 |
+| Trustworthy | 누가, 왜, 어떻게 만들었는지가 보여야 한다 |
+| Fresh | 바뀌는 정보는 실제 최신 상태여야 한다 |
+| Crawlable | 중요한 내용은 HTML/text로 접근 가능해야 한다 |
+| Differentiated | 경험, 데이터, 고객 사례, 관점이 들어가야 한다 |
+| Conversion-aware | 읽은 뒤 다음 행동이 자연스러워야 한다 |
+
+## Recommended Page Structure
+
+| Position | Must include | Standard |
+| --- | --- | --- |
+| Title | topic, intent, audience | 누가 왜 읽어야 하는지 즉시 보여야 한다 |
+| Intro | 2-3 sentence direct answer | 결론을 숨기지 않는다 |
+| Definition | standalone concept explanation | AI가 정의 문장으로 가져갈 수 있어야 한다 |
+| Context | why the problem matters | 변화와 배경을 설명한다 |
+| Framework | criteria, taxonomy, decision model | 독자가 생각을 정리할 수 있어야 한다 |
+| Evidence | numbers, examples, sources, methodology | 주장을 검증 가능하게 만든다 |
+| Comparison | alternatives and differences | buyer shortlist와 AI comparison에 들어가기 쉽다 |
+| Practical steps | ordered action path | 읽고 바로 행동할 수 있어야 한다 |
+| Caveats | limits, exceptions, non-fit cases | 과장 없이 신뢰를 높인다 |
+| CTA | next action | demo, template, audit, docs 등 자연스러운 전환 |
+
+First screen gives the answer, body builds evidence, ending creates the next action.
+
+## SEO Content Checklist
+
+| Item | Requirement |
+| --- | --- |
+| Search intent | informational, commercial, transactional, navigational 중 어디를 노리는지 분명해야 한다 |
+| SERP fit | 현재 SERP가 원하는 형식과 맞아야 한다 |
+| Keyword coverage | primary keyword뿐 아니라 related query와 sub-intent를 자연스럽게 포함한다 |
+| Internal linking | hub/spoke 구조로 관련 페이지와 연결한다 |
+| Title/meta | 검색 결과에서 클릭할 이유가 분명해야 한다 |
+| Topic authority | 한 글이 아니라 topic cluster로 권위를 만든다 |
+| Backlink-worthiness | 외부에서 링크할 원본 데이터, 도구, 표, 분석이 있어야 한다 |
+| Conversion path | 정보 소비 후 다음 단계가 명확해야 한다 |
+
+## GEO Content Checklist
+
+| Item | Requirement |
+| --- | --- |
+| Prompt fit | 사용자가 AI에게 물을 법한 자연어 질문에 답한다 |
+| Answer block | 각 주요 heading 아래에 바로 인용 가능한 답변을 둔다 |
+| Entity consistency | 브랜드명, 제품명, 카테고리, 경쟁사 대비 포지션이 일관된다 |
+| Evidence block | AI가 근거로 삼을 수 있는 숫자, 출처, 사례, quote가 있다 |
+| Comparison-ready | shortlist/recommendation 답변에 쓸 기준별 비교가 있다 |
+| Third-party alignment | 외부 정보와 모순되지 않는다 |
+| Sourceability | 문단, 표, FAQ, definition이 독립적으로 의미를 가진다 |
+| Framing control | 제품이 무엇이고, 누구에게 맞고, 누구에게 안 맞는지 명확하다 |
+| Citation likelihood | original data, benchmark, expert POV처럼 인용할 이유가 있다 |
+
+## Content Type Standards
+
+| Type | SEO purpose | GEO purpose | Must include |
+| --- | --- | --- | --- |
+| What is | category understanding | AI base definition | short definition, scope, misconceptions, examples |
+| Guide | long-tail traffic | how-to answer source | steps, checklist, practical examples |
+| Comparison | commercial intent | shortlist/recommendation entry | criteria table, pros/cons, fit/non-fit |
+| Alternatives | competitor demand | vendor recommendation entry | audience-based recommendations, differentiation, migration points |
+| Benchmark | links/authority | citation source | data, methodology, sample, date |
+| Case study | proof | trust evidence | before/after, metric, context, limits |
+| Glossary | topic coverage | entity definition | clear definition, related concept links |
+| Docs/API | technical buyer support | implementation answer source | exact specs, examples, error handling |
+| Pricing/ROI | purchase decision | cost/value answer source | price logic, formula, assumptions |
+| Template/Tool | backlink asset | practical recommendation source | usable output, examples, explanation |
+
+## B2B SaaS Priority Assets
+
+| Priority | Asset | Purpose |
+| --- | --- | --- |
+| 1 | category benchmark/report/original data | citation and authority |
+| 2 | competitor alternatives | high-intent buyer shortlist |
+| 3 | product comparison | comparison criteria for AI and buyers |
+| 4 | use-case implementation guide | proof of practical problem solving |
+| 5 | integration/migration guide | reduce adoption friction |
+| 6 | ROI/pricing calculator | quantify purchase decision |
+| 7 | customer story/teardown/before-after | proof and trust |
+| 8 | technical docs/API examples | technical evaluator and AI agent support |
+| 9 | third-party reviews/profiles/listicles | external corroboration |
+
+## Paragraph Rules
+
+Every paragraph must pass these rules:
+
+| Rule | Standard |
+| --- | --- |
+| Independence | 문단 하나만 떼어도 의미가 유지된다 |
+| Directness | 질문에 대한 답이 첫 문장에 있다 |
+| Specificity | 추상 명사보다 구체적 기준, 숫자, 예시가 있다 |
+| Verifiability | 핵심 주장에는 source, methodology, date 중 하나 이상이 붙는다 |
+| Differentiation | 누구나 아는 말이 아니라 고유한 관점이나 경험이 있다 |
+| Connectivity | 다음에 읽을 관련 페이지로 자연스럽게 이어진다 |
+
+## Table Rules
+
+Use a table only when it helps decisions or extraction.
+
+| Rule | Standard |
+| --- | --- |
+| Clear criteria | rows/columns directly help buyer decision |
+| Standalone citation | 표만 봐도 핵심 판단이 가능하다 |
+| No cherry-picking | 우리 제품에 유리한 기준만 만들지 않는다 |
+| Freshness | pricing, feature, ranking, benchmark에는 업데이트 날짜가 있다 |
+| Simple structure | AI가 항목을 추출하기 쉽다 |
+
+## Operating Loop
+
+| Step | Question | Output |
+| --- | --- | --- |
+| 1. Define prompts | ICP가 AI에게 어떤 buying/research 질문을 던지는가? | target prompt set |
+| 2. Measure visibility | 그 질문에서 우리와 경쟁사는 어떻게 언급되는가? | AI visibility baseline |
+| 3. Analyze sources | 답변은 어떤 first-party/third-party source를 근거로 삼는가? | source map |
+| 4. Find gaps | 어떤 fan-out 질문, entity, proof, third-party source가 비어 있는가? | gap backlog |
+| 5. Build assets | 어떤 페이지, 데이터, 비교, 외부 검증을 만들어야 하는가? | content brief |
+| 6. Re-measure | mention, citation, framing, referral, pipeline이 개선됐는가? | visibility report |
+
+## Measurement Framework
+
+| Goal | Metric | Meaning |
+| --- | --- | --- |
+| SEO traffic | impressions, clicks, CTR, position | 검색 결과에서 발견되고 클릭되는 정도 |
+| SEO quality | engagement, conversion, pipeline | traffic이 비즈니스 가치로 이어지는 정도 |
+| GEO visibility | prompt coverage | 목표 prompt 중 브랜드가 등장하는 비율 |
+| GEO authority | citation share | AI 답변 source/citation에 포함되는 비율 |
+| GEO positioning | framing accuracy | AI가 브랜드를 정확한 카테고리와 맥락으로 설명하는지 |
+| Competitive position | AI share of voice | 경쟁사 대비 답변 내 언급 점유율 |
+| Business impact | influenced pipeline | AI visibility가 pipeline에 영향을 준 정도 |
+
+## Anti-Patterns and Myths
+
+| Bad belief or pattern | Reality |
+| --- | --- |
+| 글자 수가 길수록 좋다 | word count magic은 없다. 의도 충족이 중요하다 |
+| keyword를 많이 넣으면 된다 | keyword stuffing은 spam이다 |
+| SEO 1등이면 AI 답변에도 나온다 | AI citation은 fan-out과 source selection 때문에 organic rank와 부분적으로만 겹친다 |
+| `llms.txt`가 GEO 필수다 | Google은 AI search 노출에 특별 파일이 필요 없다고 설명한다 |
+| schema를 많이 넣으면 AI가 인용한다 | schema는 이해를 돕지만 보장하지 않는다. visible content와 정확성이 우선이다 |
+| fake mention을 만들면 된다 | inauthentic mention과 AI manipulation은 장기 리스크다 |
+| GEO는 SEO를 대체한다 | GEO는 SEO 위에 synthesis, citation, framing layer가 추가된 것이다 |
+| 검색어만 바꾼 복붙 페이지 | doorway/scaled content 리스크 |
+| AI로 대량 생성한 일반론 | non-commodity value가 없다 |
+| 출처 없는 통계 | 신뢰와 citation 가능성이 낮다 |
+| 과장된 title | 클릭 후 만족도와 신뢰가 낮아진다 |
+| 제품 억지 끼워넣기 | 문제 해결보다 홍보로 보인다 |
+| 오래된 날짜만 갱신 | freshness 조작으로 보일 수 있다 |
+| 경쟁사 왜곡 | AI와 사용자가 cross-check할 때 신뢰를 잃는다 |
+| 숨겨진 crawler-only text | cloaking/spam 리스크 |
+| schema와 visible content 불일치 | rich result/GEO 신뢰 모두 훼손 |
+| 너무 넓은 mega post | intent와 citation 단위가 흐려진다 |
+
+## Minimum Acceptance Checklist
+
+Reject or repair the brief/content unless every answer is "yes":
+
+- 이 페이지가 답하는 primary question이 하나로 말해지는가?
+- 첫 5초 안에 핵심 답이 보이는가?
+- 사용자가 다시 검색하지 않아도 되는가?
+- 다른 글에는 없는 관점, 데이터, 경험이 있는가?
+- AI가 문장 하나를 떼어가도 의미가 유지되는가?
+- 주장에 근거가 붙어 있는가?
+- 브랜드, 제품, 카테고리, 경쟁사명이 일관되는가?
+- 관련 하위 질문으로 내부 링크가 이어지는가?
+- 최신 날짜와 실제 업데이트 내용이 맞는가?
+- 다음 행동이 명확한가?
+
+## Formulas
+
+| Goal | Formula |
+| --- | --- |
+| SEO traffic | `Search intent x Useful answer x Technical accessibility x Authority` |
+| GEO visibility | `Prompt fit x Entity clarity x Evidence density x Third-party corroboration x Citation-ready structure` |
+| B2B pipeline | `High-intent topic x Trust proof x Clear differentiation x Conversion path` |
+
+## Closing Standard
+
+이 페이지가 사람에게는 결정을 돕고, AI에게는 신뢰 가능한 근거가 되는가?
+
+이 질문에 `예`라고 답할 수 없는 콘텐츠는 SEO/GEO 자산이 아니다.

package/dist/skillpacks/geo/skills/social-execution-planning/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: social-execution-planning
+description: Use when turning a selected third-party GEO Earn action into a concrete human execution plan for Reddit, YouTube, TikTok, Instagram, or LinkedIn, including social enrichment, rule checks, drafts, execution steps, and success signals.
+---
+
+# Social Execution Planning
+
+Use this skill after a `third_party` GEO action has already been selected.
+
+This skill does not diagnose whether an Earn action should exist. It enriches one approved third-party action into an executable social plan for a human operator.
+
+## Scope
+
+Plan execution for:
+
+- Reddit posts or comment replies.
+- YouTube creator outreach.
+- TikTok creator briefs.
+- Instagram Reel or carousel briefs.
+- LinkedIn posts, comments, or outreach.
+
+Do not recommend automated posting, fake engagement, vote/comment coordination, review manipulation, undisclosed paid promotion, spam, or impersonation.
+
+## Workflow
+
+Read these references before producing a plan:
+
+- `references/execution-contract.md` for the exact output contract.
+- `references/reddit-rules.md` for Reddit rule checks and draft format.
+- `references/platform-playbooks.md` for platform-specific planning guidance.
+
+1. Start from the provided `third_party` action, policy snapshot, and backend execution context.
+2. Prefer backend-provided cited threads, URLs, creator profiles, and candidate surfaces before broad discovery.
+3. Use `firecrawl_search` for search and discovery.
+4. Use `social_analyze` for Reddit, YouTube, TikTok, Instagram, and LinkedIn URLs.
+5. Select one best execution surface when evidence is sufficient.
+6. Produce a dashboard-ready plan with surfaces, draft, execution steps, and success signal.
+7. If evidence is thin or platform rules block execution, return a conservative plan with open questions or a do-not-post path.
+
+## Output Contract
+
+Return a third-party view model:
+
+- `assetType`: always `third_party`.
+- `surfaces`: exact publish, reply, creator, or discovery surfaces.
+- `draft.format`: concrete content type.
+- `draft.angle`: audience-facing angle.
+- `draft.body`: concise execution brief or copy-paste-ready Reddit block.
+- `draft.tone`: human operator tone.
+- `executionSteps`: 2-5 ordered manual steps.
+- `successSignal`: observable measurement signal and time window.
+
+Keep the output executable by a human operator.

package/dist/skillpacks/geo/skills/social-execution-planning/agents/openai.yaml

@@ -0,0 +1,5 @@
+interface:
+  display_name: "Social Execution Planning"
+  short_description: "Turn one Earn action into a social execution plan."
+  default_prompt: "Use $social-execution-planning to enrich this third-party GEO action into a social execution plan."
+

package/dist/skillpacks/geo/skills/social-execution-planning/references/execution-contract.md

@@ -0,0 +1,68 @@
+# Social Execution Contract
+
+Use this contract when enriching one selected `assetType="third_party"` GEO action for social execution.
+
+## Inputs
+
+- `workspaceId`
+- optional `runId`
+- one `GeoStrategyAction`
+- optional policy snapshot
+- optional backend execution context
+
+The action is already selected. Do not re-run third-party diagnosis.
+
+## Tools
+
+Use:
+
+1. `firecrawl_search` for search and discovery.
+2. `social_analyze` for Reddit, YouTube, TikTok, Instagram, and LinkedIn URLs.
+
+Do not use social scraping as a substitute for platform rule checks when Reddit posting or replying is proposed.
+
+## Output
+
+Return JSON with:
+
+```json
+{
+  "assetType": "third_party",
+  "surfaces": [
+    {
+      "name": "string",
+      "url": "string | null",
+      "searchQueries": ["string"]
+    }
+  ],
+  "draft": {
+    "format": "string",
+    "angle": "string",
+    "body": "string | null",
+    "tone": "string | null"
+  },
+  "executionSteps": ["string"],
+  "successSignal": "string | null"
+}
+```
+
+## Requirements
+
+- `surfaces` must include at least one exact surface or a rerunnable discovery surface.
+- `executionSteps` must contain 2-5 ordered manual steps.
+- `successSignal` must describe an observable signal and time window when possible.
+- Do not invent platform rules, creator contacts, metrics, brand claims, or user experiences.
+- If evidence is thin, lower confidence in the draft body and list open questions.
+
+## Safety Boundaries
+
+Never recommend:
+
+- automated posting.
+- fake engagement.
+- vote/comment brigading.
+- review manipulation.
+- undisclosed paid promotion.
+- spam.
+- hiding AI assistance to evade moderation.
+- impersonation or fabricated personal experience.

package/dist/skillpacks/geo/skills/social-execution-planning/references/platform-playbooks.md

@@ -0,0 +1,59 @@
+# Social Platform Playbooks
+
+## YouTube
+
+Use for creator outreach, comparison reviews, explainers, or product mention opportunities.
+
+Plan should include:
+
+- target creator or channel URL when known.
+- why audience fit is credible.
+- outreach angle.
+- no content approval requirement unless explicitly allowed by policy.
+- success signal such as creator mention, review, or citation movement.
+
+## TikTok
+
+Use for short-form creator briefs and trend-compatible education.
+
+Plan should include:
+
+- creator/profile or rerunnable discovery query.
+- video angle.
+- claim constraints.
+- disclosure needs.
+- observable signal such as creator post, engagement quality, or AI answer citation movement.
+
+## Instagram
+
+Use for Reel, carousel, creator outreach, or owned profile improvement.
+
+Plan should include:
+
+- profile or creator surface.
+- visual/story angle.
+- caption or creator brief.
+- disclosure needs.
+- measurement window.
+
+## LinkedIn
+
+Use for professional commentary, founder/operator post, or relevant thread comment.
+
+Plan should include:
+
+- target post, company profile, person profile, or discovery query.
+- business-facing angle.
+- draft or outreach brief.
+- evidence and claims used.
+- success signal such as indexed post, relevant replies, or AI answer citation movement.
+
+## General No-Action Cases
+
+Prefer a conservative plan or open questions when:
+
+- no exact surface can be found.
+- audience fit is speculative.
+- platform rules block participation.
+- verified claims are insufficient.
+- the action would require fake personal experience or undisclosed promotion.

package/dist/skillpacks/geo/skills/social-execution-planning/references/reddit-rules.md

@@ -0,0 +1,69 @@
+# Reddit Execution Rules
+
+For Reddit actions, choose one:
+
+- `comment_reply`: answer a specific existing high-signal thread.
+- `new_post`: create a useful-first post for a specific subreddit.
+- `ask_mods_first`: request moderator approval before posting.
+- `do_not_post`: rules or context make participation unsafe.
+
+## Discovery
+
+Use `firecrawl_search` to find candidate threads or subreddits.
+
+Prefer backend-provided `redditCitationContext` threads when present.
+
+Analyze the selected Reddit URL with `social_analyze` before drafting.
+
+## Rule Check
+
+Before drafting, inspect the selected subreddit rules when available.
+
+Summarize this block in `draft.body`:
+
+```text
+ruleCheck:
+sourceUrl: https://www.reddit.com/r/example/about/rules
+relevantRules:
+- Rule name: why it matters
+verdict: allowed | ask_mods_first | do_not_post
+reason: One sentence tied to the rules.
+```
+
+Use `do_not_post` when rules prohibit business participation, self-promotion, AI-generated content, surveys, undisclosed promotion, or brand representatives.
+
+Use `ask_mods_first` when moderator approval is required or ambiguity is material.
+
+## Reddit Plan Body
+
+For Reddit, include a copy-paste-ready block:
+
+```text
+redditPlan:
+mode: comment_reply | new_post | ask_mods_first | do_not_post
+subreddit: r/example
+targetThreadUrl: https://www.reddit.com/r/example/comments/...
+postTitle: Short non-promotional title for new_post only
+commentDraft: |
+  Copy-paste-ready Reddit comment for allowed comment_reply only.
+postBody: |
+  Copy-paste-ready Reddit post body for allowed new_post only.
+modmailDraft: |
+  Permission request for ask_mods_first only.
+disclosureLine: Required affiliation line, or "Not needed: no brand/product mention."
+claimsUsed:
+- Verified claim from the action or analyzed thread
+doNotPostIf:
+- Subreddit rules prohibit brand participation
+```
+
+## Drafting Rules
+
+- Be useful first.
+- Answer the community's question.
+- Cite only verified facts from the input or analyzed thread.
+- Avoid promotional language.
+- Disclose brand/operator affiliation when recommending the brand, linking to it, or speaking from official capacity.
+- Do not volunteer AI assistance unless rules or operator policy require it.
+- Do not directly name the brand unless the thread, question, or objective makes it materially relevant.
+- Do not draft first-person lived experience, testimonials, location claims, or user identities unless verified facts explicitly provide them.

package/dist/skillpacks/geo/skills/third-party-diagnosis/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: third-party-diagnosis
+description: Use when diagnosing third-party citation surfaces, external authority gaps, competitor presence on external sources, profile/listing opportunities, reviews, or social sentiment risks.
+---
+
+# Third-Party Diagnosis
+
+Use this skill for directly callable Earn / third-party diagnosis.
+
+The output is a compact diagnosis plus action candidates for `assetType="third_party"`.
+
+## Scope
+
+Diagnose:
+
+- Cited third-party domains.
+- Competitor presence on external sources.
+- Tenant-owned third-party profiles.
+- Submission, listing, review, and inclusion opportunities.
+- External sentiment risk on social or community surfaces.
+
+Do not recommend third-party work just because a domain is frequently cited. Prefer no action when the path is speculative.
+
+## Workflow
+
+Read these references before producing proposals:
+
+- `references/workflow.md` for the full third-party product workflow, actionability boundaries, candidate types, evidence gates, social handling, and no-action cases.
+- `references/diagnosis-contract.md` for the exact runtime diagnosis contract and artifact submission shape.
+
+1. Read shared run context and the third-party candidate slice.
+2. Use `get_citation_intelligence` before lower-level citation calls.
+3. Use `list_geo_strategy_candidates` for actionable domain slices.
+4. Use `get_geo_intent_diagnostic` when intent-level citation behavior matters.
+5. Use `social_analyze` for YouTube, Reddit, TikTok, Instagram, or LinkedIn URLs.
+6. Use `web_scrape` only for specific non-social pages where feasibility or profile quality must be checked.
+7. Use `web_search` only to find an official submission/profile path or verify actionability.
+
+## Output Contract
+
+Each proposal should include:
+
+- exact third-party source domain.
+- exact publish surface URL when known.
+- content format and content angle.
+- 2-4 concrete execution steps.
+- expected outcome.
+- root cause, priority, confidence, risks, and evidence.
+
+Allowed no-action outcomes:
+
+- external path is not actionable.
+- citation signal exists but no credible submission/profile/update path exists.
+- owned or generated page coverage is the clearer bottleneck.

package/dist/skillpacks/geo/skills/third-party-diagnosis/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Third-Party Diagnosis"
+  short_description: "Diagnose external citation and Earn opportunities."
+  default_prompt: "Use $third-party-diagnosis to diagnose third-party GEO opportunities for this workspace."