{"slug":"mblode-optimise-seo","name":"optimise-seo","description":"Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program.","long_description":"---\nname: optimise-seo\ndescription: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program.\n---\n\n# Optimise SEO\n\n- **IS:** crawlability, metadata, structured data, canonicals, redirects, status codes, hreflang, AI-crawler policy and extractable page structure, Core Web Vitals, programmatic SEO, security and privacy headers, and error-page behaviour, implemented in a Next.js App Router codebase.\n- **IS NOT:** visual redesign, layout, or page-level UI quality (`ui-design` Direction, Build, and Audit modes), demand research, briefs, question maps, or Search Console monitoring (`seo-program`), tenant routing for `robots.txt` and `sitemap.xml` (`multi-tenant-architecture`), or writing the article (external `ghostwriter`).\n\nAllowed surface: `metadata` and `generateMetadata`, JSON-LD, semantic HTML, internal links, alt text, `app/sitemap.ts`, `app/robots.ts`, `app/feed.xml/route.ts`, `app/llms.txt/route.ts`, `proxy.ts`, `next.config.ts` redirects and headers, error pages, and performance work. Component styling and layout stay as they are; when a fix needs a layout change, name it as a handoff to `ui-design`.\n\nBefore writing code, read the matching guide in `node_modules/next/dist/docs/` (resolved from the app directory; in a monorepo the `next` package is not visible from the repo root). The bundled docs match the installed version; the notes in `references/nextjs-implementation.md` were checked against 16.3 and say where behaviour changed.\n\n## References\n\n| File | Read when |\n|---|---|\n| [references/indexing-policy.md](references/indexing-policy.md) | Redirects, duplicate URLs, index decisions, or pages generated at scale |\n| [references/nextjs-implementation.md](references/nextjs-implementation.md) | Before writing code in steps 2-4: metadata, sitemap and robots, redirects, indexing, streaming 404s, JSON-LD, OG images, CSP |\n| [references/answer-engines.md](references/answer-engines.md) | The task touches AI crawlers, `robots.ts` rules for GPTBot or ClaudeBot, `llms.txt`, Content-Signal, or \"why are we not cited\" |\n| [references/internationalisation.md](references/internationalisation.md) | The site has more than one locale |\n| [references/technical-hardening.md](references/technical-hardening.md) | Headers, cookies, consent, GPC, `security.txt`, or maintenance and error-status tasks |\n| [references/validation-evidence.md](references/validation-evidence.md) | Step 5: served-page commands and evidence expectations |\n| [references/seo-checklist.md](references/seo-checklist.md) | Step 5: copy into the report and mark each line with evidence |\n\n## Workflow\n\nCopy and track this checklist:\n\n```text\nSEO progress:\n- [ ] Step 1: Inventory routes and decide index intent per route\n- [ ] Step 2: Fix crawl/index foundations (sitemap, robots, canonicals, redirects, status codes)\n- [ ] Step 3: Implement metadata and structured data\n- [ ] Step 4: Improve semantics, extractable answers, internal links, and Core Web Vitals\n- [ ] Step 5: Validate with references/seo-checklist.md and report evidence\n```\n\nStep 1 is a table: route, index or noindex, canonical, reason. Every later step reads from it, and a route with no row gets no work.\n\n## Must-have on every site\n\n- `app/sitemap.ts` lists every indexable URL with `lastModified` derived from content; `app/robots.ts` names it\n- One canonical per page, one host, one casing, one trailing-slash policy, set through `alternates.canonical` with `metadataBase` in the root layout. Next.js enforces the slash policy itself: by default it 308s `/about/` to `/about`, and `trailingSlash: true` inverts that (files with extensions and `.well-known/` paths are exempt either way)\n- Preserve the property's existing ownership verification. Use `metadata.verification` only for a supplied token and the chosen verification method; DNS verification needs no duplicate meta tag\n- Root layout `robots` lifts Google's default preview caps: `googleBot: { 'max-snippet': -1, 'max-image-preview': 'large', 'max-video-preview': -1 }`. Without them Google truncates the snippet and the image preview, and the snippet cap is what AI surfaces read against when deciding how much of a page they may quote\n- `authors` and `creator` set explicitly in the root layout, so person-level attribution does not live only in footer HTML and JSON-LD\n- Unique title and description per page; title and H1 lead with the non-brand primary keyword and agree in intent (a brand-led title on a category page competes only for navigational queries the site already wins)\n- Every page opens with a short, plain-text answer to the question it exists to answer; the h2s are the questions people actually ask\n- Open Graph and Twitter Card tags with a 1200x630 image\n- JSON-LD: Organization and WebSite once in a root `@graph` with stable `@id`s, BreadcrumbList on inner pages, then Article, Product, ProfilePage, or LocalBusiness where the content type matches. Define an entity once and reference it by `@id`\n- One h1, logical h2-h6, descriptive alt text, internal links between related pages\n- Core Web Vitals in target at the p75 of CrUX field data: LCP 2.5 s, INP 200 ms, CLS 0.1 (INP replaced FID in March 2024; a guide still naming FID is stale)\n\n## Redirects and indexing policy\n\nLoad `references/indexing-policy.md` when routes move, duplicates need consolidation, or page indexing policy changes. Verify behavior against the installed Next.js version and served responses.\n\n## AI crawlers and answer engines\n\nGoogle needs no special files: AI Overviews and AI Mode run on Googlebot and core ranking, and `nosnippet` or `max-snippet:0` is the only opt-out (it removes the normal snippet too). Everything else is a robots decision per crawler class: search and citation bots (`OAI-SearchBot`, `Claude-SearchBot`, `PerplexityBot`) put a site in answers; training bots (`GPTBot`, `ClaudeBot`, `CCBot`) do not; `Google-Extended` and `Applebot-Extended` are usage tokens with no crawler behind them. `llms.txt` costs one route and earns almost nothing measurable. The full table, `robots.ts` rules, Content-Signal, and the Markdown-alternate patterns are in `references/answer-engines.md`.\n\n## Programmatic SEO\n\nFor pages generated at scale, load `references/indexing-policy.md`. Require demand evidence and unique page value before indexing a new pattern.\n\n## Audit triage order\n\n1. Crawl and index: robots, sitemap, stray `noindex`, canonicals, redirect chains, soft 404s\n2. Technical: HTTPS, Core Web Vitals field data, mobile and desktop parity, AI-crawler access through the CDN\n3. On-page: title and H1 uniqueness and non-brand lead, extractable answer, internal links, thin pages\n4. Orphans: indexable pages with no internal link or sitemap entry; give them a crawl path or `noindex` and drop them. A sitewide footer link is not a crawl path on a low-authority domain: Google discounts footer boilerplate, and a section linked only from the footer can sit at \"URL is unknown to Google\" for months while nav-linked pages beside it are crawled daily\n\nReport in the same order: what blocks indexation first, then on-page and schema gaps, then the single next fix. Twenty equal-weight findings get none of them done. Report length follows what was found, not the section list. Treat third-party audit tools as leads, not findings: several flag Next.js output falsely (a missing `<meta name=\"title\">` when `<title>` is present, \"duplicate\" `theme-color` tags that are light and dark variants, repeated `article:tag`), and at least one agent-skill auditor silently skips modules unless given an explicit module list and passes a `FAQPage` whose answers never render. Verify each lead against the served HTML before it goes in the report.\n\n## Gotchas\n\n- Under `cacheComponents: true` (the `scaffold-nextjs` default) the `dynamic`, `dynamicParams`, `revalidate`, and `fetchCache` segment configs are build errors: `export const revalidate` on `app/sitemap.ts`, `dynamic = 'force-static'` on a `robots.txt/route.ts` handler, `fetchCache` anywhere (`runtime`, `maxDuration`, `instant`, and `prefetch` remain valid). Move the content fetch into a separate `'use cache'` helper with `cacheLife('hours')` and `cacheTag`, called from the page or `GET` (the directive cannot sit on the `GET` export itself), and `revalidateTag(tag, 'max')` from the publish webhook. Revalidation does not purge a CDN in front of the app; purge it in the same webhook.\n- `generateSitemaps()` writes `/product/sitemap/0.xml`, `/product/sitemap/1.xml`, and no index file. List each generated file in `robots.ts` (`sitemap` takes an array) or hand-write the index at `app/sitemap.xml/route.ts`; otherwise Google sees only the ones it stumbles on.\n- `lastModified: new Date()` on every sitemap row marks the whole site as changed on every deploy; Google then ignores `lastmod` sitewide. `priority` and `changeFrequency` are ignored outright, so emitting them buys nothing and clutters the diff.\n- No `Host:` line in `robots.txt`. Yandex dropped the directive in 2018 in favour of a 301 to the preferred host, which `next.config.ts` already serves, and auditors flag the leftover line as an unknown directive. Leave `host` out of the `robots.ts` return value.\n- Next.js replaces object-valued metadata (`openGraph`, `twitter`, `robots`, `alternates`) wholesale when a child segment declares the key; it does not deep-merge. A page that adds `openGraph: { title }` loses the inherited `siteName`, `images`, and `locale`, and `images: undefined` counts as a declaration. When you add one of these blocks to a route, every field the parent supplied becomes yours to restate. Scalars (`title`, `description`, `authors`, `creator`) merge normally.\n- `title.template` applies to `<title>` only. `og:title` resolves against `openGraph.title.template`, a separate mechanism, so stripping a hand-rolled suffix from a page title silently strips the product name from the share card. Set both templates in the layout, or neither. A bare string `title` in a nested layout also resets the parent template to null for that subtree; return `{ default, template }` instead.\n- Never set `openGraph.url` in a root layout. It is not per-page, every route inherits it, and every share collapses onto the home URL. A child cannot fix it without declaring `openGraph` and losing the rest of the block. Absent beats wrong: consumers fall back to the URL they fetched, and `alternates.canonical` is already per-page.\n- `middleware.ts` is deprecated in Next.js 16. New request-time logic (slug checks, CSP nonces, `Accept` negotiation) goes in `proxy.ts` with an exported `proxy` function; `npx @next/codemod@canary middleware-to-proxy .` moves an existing file. Proxy is Node.js only; `runtime` is not a valid export there.\n- `next.config.ts` redirects match in array order and `:path*` swallows everything beneath it, so a specific source placed after a catch-all is dead code, and a bare `/old` must sit above `/old/:path*` or it lands on `/new/`. Vercel caps the list at 1,024 rules; past that, move the map into `proxy.ts`.\n- Next owns the `Vary` header on App Router HTML responses and replaces it with its RSC list (`rsc, next-router-state-tree, ...`). A `Vary: Accept` set in `proxy.ts` on `NextResponse.next()`, or in `headers()`, never reaches the client. It survives only on a `Response` you construct yourself, so content-negotiated Markdown must be returned directly, not rewritten to.\n- `notFound()` after a Suspense boundary or `loading.tsx` has flushed returns 200 with a `noindex` meta, not 404. Without Cache Components, call it before the first suspending `await`; with Cache Components the docs are explicit that every dynamic route streams a static shell first, so the existence check moves to `proxy.ts`. Analytics and uptime monitors otherwise see a health","tagline":"Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use se","category":"research","tags":["agent-skill"],"author":"mblode","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"github candidate review","sourceDetail":"mblode/agent-skills","creatorName":"mblode","creatorUrl":"https://github.com/mblode","sourceUrl":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/mblode-optimise-seo#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":104,"forks":10,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":37.7},"quality":{"score":67,"tier":"promising","label":"Promising","summary":"Useful candidate, but compare it with alternatives before adopting.","signals":[{"label":"GitHub stars","value":"104","tone":"neutral"},{"label":"Freshness","value":"2d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"MIT","tone":"neutral"}],"warnings":[]},"trust":{"version":"trust-score-v5","score":65,"base_score":73,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["65/100 Trust Score v5","73/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"104 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":57,"weight":0.08,"status":"warn","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"2d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"command execution surface, credential or environment access"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":18,"weight":0.07,"status":"fail","detail":"secrets or environment access, shell or command execution"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"104 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"2d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"command execution surface, credential or environment access"},{"status":"pass","label":"Install availability","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, shell or command execution"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"104 GitHub stars","repoActivity":"104 stars, 10 forks","lastPushed":"2d since push","license":"MIT","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","install":"npx skills add mblode/agent-skills --skill optimise-seo","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, shell or command execution","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add mblode/agent-skills --skill optimise-seo","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","2d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["research","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add mblode/agent-skills --skill optimise-seo","trust_score":65,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":73,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v5":{"version":"trust-score-v5","score":65,"base_score":73,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["65/100 Trust Score v5","73/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"104 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":57,"weight":0.08,"status":"warn","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"2d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"command execution surface, credential or environment access"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":18,"weight":0.07,"status":"fail","detail":"secrets or environment access, shell or command execution"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"104 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"2d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"command execution surface, credential or environment access"},{"status":"pass","label":"Install availability","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, shell or command execution"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"104 GitHub stars","repoActivity":"104 stars, 10 forks","lastPushed":"2d since push","license":"MIT","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","install":"npx skills add mblode/agent-skills --skill optimise-seo","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, shell or command execution","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add mblode/agent-skills --skill optimise-seo","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","2d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["research","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add mblode/agent-skills --skill optimise-seo","trust_score":65,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":73,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v4":{"version":"trust-score-v4","score":73,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout.","recommendedAction":"Test in a sandbox workflow and compare its install path with close alternatives.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":62,"weight":0.13,"status":"info","detail":"104 GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":57,"weight":0.08,"status":"warn","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"2d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":46,"weight":0.12,"status":"warn","detail":"command execution surface, credential or environment access"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":18,"weight":0.07,"status":"fail","detail":"secrets or environment access, shell or command execution"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"id":"review_status","label":"Review status","score":88,"weight":0.05,"status":"pass","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"info","label":"GitHub adoption","detail":"104 GitHub stars"},{"status":"warn","label":"Stars/forks activity","detail":"104 stars, 10 forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"2d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"warn","label":"Dependency/runtime risk","detail":"command execution surface, credential or environment access"},{"status":"pass","label":"Install availability","detail":"npx skills add mblode/agent-skills --skill optimise-seo"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"fail","label":"Permission surface","detail":"secrets or environment access, shell or command execution"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo"},{"status":"pass","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"info","label":"OpenAgentSkill usage","detail":"No local usage activity yet"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Install command has no obvious high-risk pattern"],"warnings":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"],"evidence":{"stars":"104 GitHub stars","repoActivity":"104 stars, 10 forks","lastPushed":"2d since push","license":"MIT","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","install":"npx skills add mblode/agent-skills --skill optimise-seo","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, shell or command execution","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add mblode/agent-skills --skill optimise-seo","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","2d since push"]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["research","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":33,"level":"avoid_auto_install","label":"Avoid automatic install","safety_tier":{"tier":"blocked","label":"Blocked for auto-install","badge":"BLOCKED","summary":"This skill should not be selected by an agent without explicit human security review.","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","auto_install_policy":"block","reasons":["Metadata combines secrets access with shell or command execution","High-risk permission hints: Shell or command execution, Secrets or environment access"]},"auto_install_allowed":false,"human_review_required":true,"blocked":true,"audit_risk":"needs_review","permission_hints":[{"id":"shell","label":"Shell or command execution","reason":"Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.","severity":"high"},{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"secrets","label":"Secrets or environment access","reason":"Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.","severity":"high"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["High-risk permission hints: Shell or command execution, Secrets or environment access","Dependency or permission surface needs review"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","badge":"BLOCKED","auto_install_policy":"block","auto_install_allowed":false,"blocked":true,"human_review_required":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","reasons":["Metadata combines secrets access with shell or command execution","High-risk permission hints: Shell or command execution, Secrets or environment access"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"failed","score":66,"risk_level":"high","decision":{"recommendation":"do_not_auto_install","reason":"Agent safety gate: This skill should not be selected by an agent without explicit human security review.","auto_install_allowed":false,"policy":"block","human_review_required":true},"blockers":["Agent safety gate: This skill should not be selected by an agent without explicit human security review.","Permission surface: secrets or environment access, shell or command execution"],"warnings":["Trust score: Good trust signals with a few areas worth checking before rollout.","Audit score: Needs review","High-risk permission hints: Shell or command execution, Secrets or environment access","Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":94,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate optimise-seo before installing it in an agent workflow","research","Local desktop workflows; Claude Code teams; builders willing to evaluate younger projects"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add mblode/agent-skills --skill optimise-seo"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add mblode/agent-skills --skill optimise-seo"]},{"id":"trust_score","label":"Trust score","status":"warn","score":73,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","104 GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"warn","score":77,"required_for_auto_install":true,"detail":"Needs review","evidence":["Dependency or permission surface needs review"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"fail","score":33,"required_for_auto_install":true,"detail":"This skill should not be selected by an agent without explicit human security review.","evidence":["Do not auto-install. Inspect the source, dependencies, and permission surface first.","Metadata combines secrets access with shell or command execution"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"pass","score":86,"required_for_auto_install":false,"detail":"Metadata includes enough usage and workflow context","evidence":["Strong README/SKILL.md context"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"2d since push","evidence":["2d since push"]},{"id":"permission_surface","label":"Permission surface","status":"fail","score":18,"required_for_auto_install":true,"detail":"secrets or environment access, shell or command execution","evidence":["Shell or command execution: high","Network access: medium","Filesystem access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/mblode-optimise-seo/evals","api":"/api/agent/evals?slug=mblode-optimise-seo","text":"/api/agent/evals?slug=mblode-optimise-seo&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"mblode-optimise-seo","name":"optimise-seo","description":"Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program.","category":"research","url":"https://www.openagentskill.com/skills/mblode-optimise-seo","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","github_repo":"mblode/agent-skills"},"suited_tasks":["Local desktop workflows","Claude Code teams","builders willing to evaluate younger projects","Navigate local resources","Run repeatable desktop actions","Verify file outputs","Crawl target URLs","Extract tables and metadata"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","OpenAI Agents","CLI"],"install":{"command":"npx skills add mblode/agent-skills --skill optimise-seo","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add mblode-optimise-seo"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"optimise-seo\" agent skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"optimise-seo\" as a Claude Code skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"optimise-seo\" from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/mblode-optimise-seo/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/mblode-optimise-seo"},"trust":{"score":73,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"104 GitHub stars","repoActivity":"104 stars, 10 forks","lastPushed":"2d since push","license":"MIT","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","install":"npx skills add mblode/agent-skills --skill optimise-seo","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, shell or command execution","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["research","agent-skill"],"known_risks":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":77,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","auto_install_policy":"block","auto_install_allowed":false,"human_review_required":true,"blocked":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first."},"quality":{"score":67,"label":"Promising"},"supply":{"track":"Research and knowledge work","scenario":"Research agents","maintenance":"2d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","High-risk permission hints: Shell or command execution, Secrets or environment access","Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution"],"agent_contract":{"task_input":"Use optimise-seo in an agent workflow","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","install_policy":"block","minimum_review_before_use":["Trust: 73/100 Strong shortlist","Audit: 77/100 Needs review","Safety: 33/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"mblode-optimise-seo (optimise-seo)","install_command":"npx skills add mblode/agent-skills --skill optimise-seo","risk_summary":"Needs review; Blocked for auto-install; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"mblode-optimise-seo","task":"Use optimise-seo in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/mblode-optimise-seo","api":"https://www.openagentskill.com/api/agent/skills/mblode-optimise-seo","audit":"https://www.openagentskill.com/skills/mblode-optimise-seo/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=mblode-optimise-seo&task=Use%20optimise-seo%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20optimise-seo%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20optimise-seo%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/mblode-optimise-seo/install","manifest":"https://www.openagentskill.com/api/registry/manifest/mblode-optimise-seo"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"mblode-optimise-seo","name":"optimise-seo","description":"Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program.","category":"research","url":"https://www.openagentskill.com/skills/mblode-optimise-seo","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","github_repo":"mblode/agent-skills"},"suited_tasks":["Local desktop workflows","Claude Code teams","builders willing to evaluate younger projects","Navigate local resources","Run repeatable desktop actions","Verify file outputs","Crawl target URLs","Extract tables and metadata"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","OpenAI Agents","CLI"],"install":{"command":"npx skills add mblode/agent-skills --skill optimise-seo","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add mblode-optimise-seo"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"optimise-seo\" agent skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"optimise-seo\" as a Claude Code skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"optimise-seo\" from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/mblode-optimise-seo/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/mblode-optimise-seo"},"trust":{"score":73,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"104 GitHub stars","repoActivity":"104 stars, 10 forks","lastPushed":"2d since push","license":"MIT","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","install":"npx skills add mblode/agent-skills --skill optimise-seo","installSafety":"standard package or runtime install path","permissionSurface":"secrets or environment access, shell or command execution","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["research","agent-skill"],"known_risks":["Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":77,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"safety_gate":{"tier":"blocked","label":"Blocked for auto-install","auto_install_policy":"block","auto_install_allowed":false,"human_review_required":true,"blocked":true,"recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first."},"quality":{"score":67,"label":"Promising"},"supply":{"track":"Research and knowledge work","scenario":"Research agents","maintenance":"2d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","high-compliance environments without internal security review","No OpenAgentSkill engagement data yet","High-risk permission hints: Shell or command execution, Secrets or environment access","Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution"],"agent_contract":{"task_input":"Use optimise-seo in an agent workflow","recommended_action":"Do not auto-install. Inspect the source, dependencies, and permission surface first.","install_policy":"block","minimum_review_before_use":["Trust: 73/100 Strong shortlist","Audit: 77/100 Needs review","Safety: 33/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"mblode-optimise-seo (optimise-seo)","install_command":"npx skills add mblode/agent-skills --skill optimise-seo","risk_summary":"Needs review; Blocked for auto-install; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"mblode-optimise-seo","task":"Use optimise-seo in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/mblode-optimise-seo","api":"https://www.openagentskill.com/api/agent/skills/mblode-optimise-seo","audit":"https://www.openagentskill.com/skills/mblode-optimise-seo/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=mblode-optimise-seo&task=Use%20optimise-seo%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20optimise-seo%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20optimise-seo%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/mblode-optimise-seo/install","manifest":"https://www.openagentskill.com/api/registry/manifest/mblode-optimise-seo"}},"supply_profile":{"track":{"slug":"research","label":"Research and knowledge work","shortLabel":"Research","description":"Deep research, source comparison, literature review, RAG, knowledge search, and reports."},"scenario":{"label":"Research agents","description":"I need my agent to research a topic, compare sources, and produce a concise report.","useCases":[{"slug":"local-desktop","title":"Local desktop"},{"slug":"web-scraping","title":"Web scraping"},{"slug":"research-agents","title":"Research agents"}]},"applicableAgents":["Claude Code","OpenAI Agents","CLI","Codex","Cursor"],"install":{"ready":true,"command":"npx skills add mblode/agent-skills --skill optimise-seo","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":104,"starsLabel":"104","forks":10,"license":"MIT","qualityScore":67,"trustScore":73,"auditScore":77},"maintenance":{"status":"fresh","label":"2d since push","daysSincePush":2,"lastPushedAt":"2026-09-05T05:59:05+00:00"},"risk":{"level":"needs_review","label":"Needs review","requiresReview":true,"notes":["Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata"]},"coverageTags":["Research","Research agents","agent-skill"]},"audit":{"audit_score":77,"risk_level":"needs_review","risk_label":"Needs review","quality_score":67,"trust_score":73,"maintenance_score":100,"security_score":75,"install_score":92,"warnings":["Dependency or permission surface needs review","Permission surface may require sandboxing","Quality score needs review","Permission surface needs review: secrets or environment access, shell or command execution","Stars/forks activity: 104 stars, 10 forks; issue activity unavailable in current metadata","Dependency/runtime risk: command execution surface, credential or environment access","Permission surface: secrets or environment access, shell or command execution"]},"quality_signals":{"model":"v2","star_score":14.15,"usage_score":0,"review_score":5.55,"metadata_score":3,"freshness_score":15},"platforms":["Claude Code","OpenAI Agents"],"use_cases":[{"slug":"local-desktop","title":"Local desktop","url":"https://www.openagentskill.com/use-cases/local-desktop"},{"slug":"web-scraping","title":"Web scraping","url":"https://www.openagentskill.com/use-cases/web-scraping"},{"slug":"research-agents","title":"Research agents","url":"https://www.openagentskill.com/use-cases/research-agents"},{"slug":"workflow-automation","title":"Workflow automation","url":"https://www.openagentskill.com/use-cases/workflow-automation"}],"stacks":[{"slug":"web-data-pipeline","title":"Web data pipeline","url":"https://www.openagentskill.com/collections/web-data-pipeline"},{"slug":"research-report-agent","title":"Research report agent","url":"https://www.openagentskill.com/collections/research-report-agent"},{"slug":"content-growth-agent","title":"Content growth agent","url":"https://www.openagentskill.com/collections/content-growth-agent"}],"install":"npx skills add mblode/agent-skills --skill optimise-seo","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add mblode-optimise-seo","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"optimise-seo\" agent skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"optimise-seo\" as a Claude Code skill from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"optimise-seo\" from https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to \"fix SEO\", \"add a sitemap\", \"fix soft 404s\", or \"add llms.txt\". For demand research, briefs, or Search Console monitoring use seo-program. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"mblode-optimise-seo\",\"task\":\"Install optimise-seo\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","github_repo":"mblode/agent-skills","version":"1.0.0","license":"MIT","urls":{"web":"https://www.openagentskill.com/skills/mblode-optimise-seo","repository":"https://github.com/mblode/agent-skills/tree/main/skills/optimise-seo","api":"/api/agent/skills/mblode-optimise-seo","install_api":"/api/skills/mblode-optimise-seo/install"},"meta":{"created_at":"2026-09-07T04:10:20.088972+00:00","updated_at":"2026-09-07T04:10:20.238404+00:00","agent_friendly":true}}