{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Skills Authoring and Publishing Instructions","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"skills-authoring-and-publishing-instructions","__idx":0},"children":["Skills Authoring and Publishing Instructions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these rules when creating or editing canonical skill files and the associated discovery metadata under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the single internal source of truth for all Worldpay skill authoring and publishing work. Keep one authoring workflow, not separate public and private processes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scope","__idx":1},"children":["Scope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These instructions apply to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["canonical skill markdown at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/<slug>/SKILL.md"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["per-skill metadata at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/<slug>/index.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["root discovery manifest at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/index.json"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"objective","__idx":2},"children":["Objective"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create implementation-first skill documents that coding agents can execute directly, and keep the public discovery metadata aligned with the canonical docs and product scope."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-workflow-for-new-skills","__idx":3},"children":["Required Workflow For New Skills"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create or update the canonical skill markdown at:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/<slug>/SKILL.md"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create or update the per-skill metadata file at:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/<slug>/index.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It must include:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["source reference (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["repositoryPath"]},") to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/<slug>/SKILL.md"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["public file reference to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/skills/<slug>/SKILL.md"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Update the root discovery manifest at:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/index.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add or update a new entry in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skills[]"]}," with:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["human-readable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["concise ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["homepage"]}," pointing to the product landing/docs route (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products/<product>/"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," pointing to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/skills/<slug>/index.json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["files"]}," including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/.well-known/skills/<slug>/SKILL.md"]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-section-structure","__idx":4},"children":["Required Section Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep this section order unless there is a strong reason to deviate:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["# <Skill Name>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Purpose"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## When To Use This Skill"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## When Not To Use This Skill"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Audience"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Source Docs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Required Inputs Before Coding"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Expected Outputs From The Assistant"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Integration Decision Tree"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Guardrails For Assistant Behavior"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Core Reliability Rules"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Minimal Request Pattern"]}," (when API-based)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Outcome Handling Contract"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Testing Strategy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Security and Compliance Baseline"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Go-Live Checklist"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Editor Assistant Prompt Starters"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["## Anti-Patterns"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-frontmatter","__idx":5},"children":["Required Frontmatter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every skill file must include frontmatter with these keys:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},": lowercase slug matching the skill folder"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]},": what the skill does and when to use it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},": repo-specific string values for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["owner"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_updated"]}," (ISO date: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep custom fields inside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},", not at the top level. Quote ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_updated"]}," so YAML parses it as a string."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"writing-rules","__idx":6},"children":["Writing Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Write for engineers implementing production integrations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prefer imperative instructions and deterministic behavior."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep examples minimal but executable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use full HTTPS URLs for published source docs in skill bodies so links work outside the documentation site; verify the published routes rather than linking to repository ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".md"]}," paths."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use relative paths for files bundled within the skill, and root-relative paths for public discovery metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include explicit handling for unhappy paths."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid marketing language and product fluff."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For API skills, always start with a required journey gate: exact flow, channel, and business pattern before coding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prefer the canonical product journey names used in the docs (for example guest payment, stored card, recurring first, recurring subsequent, wallet, card-on-file)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reusable-skill-pattern","__idx":7},"children":["Reusable Skill Pattern"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this repeatable structure for all API-based skills:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clearly define the exact product journeys covered."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Require the assistant to identify the flow before implementation begins."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["State the canonical source docs for the primary journeys and stable feature guides."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a minimal request example that matches the documented request schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add a decision tree for journey selection, 3DS or policy gates, and token/session vs direct data handling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include reliability, security, testing, and go-live requirements tailored to the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exclude experimental or niche variants unless the product docs explicitly support them as standard."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"content-quality-rules","__idx":8},"children":["Content Quality Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not invent API fields, endpoint behavior, or outcome semantics."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If policy-dependent behavior exists (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review"]}," handling), require explicit business policy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include at least one observability requirement (correlation IDs, logging, metrics, or tracing)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include at least one idempotency/retry requirement when API calls or events are involved."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a test matrix covering happy path and high-risk/error paths."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep metadata references limited to stable canonical product docs and feature guides; do not include experimental or unsupported variants in the public skill index."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"publishing-and-metadata-rules","__idx":9},"children":["Publishing and Metadata Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep canonical skill content, public ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".well-known"]}," files, and discovery metadata in sync."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["slug"]}," values must be consistent across the markdown file, metadata file, and root manifest."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Public file paths must exist at the exact declared paths."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use lowercase slugs matching the folder name and metadata file name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep public discovery limited to stable, canonical docs and supported product journeys."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Omit experimental or niche variants from the public metadata unless intentionally released."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"documentation-alignment","__idx":10},"children":["Documentation Alignment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a change introduces a new published skill, also update references where relevant:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/README.md"]}," published skills notes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products/ai/index.md"]}," summary text such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Currently published:"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/products/ai/index.md"]}," so the exact sentence reflects every skill currently listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/index.json"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validation-checklist-always-run","__idx":11},"children":["Validation Checklist (Always Run)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All changed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".json"]}," files parse as valid JSON."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Discovery metadata paths use root-relative URLs; source-doc links in skill bodies use verified HTTPS URLs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["slug"]}," values are consistent across all three files."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Public file exists at the exact path declared in both manifest files."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the lowercase slug that matches the folder name and the metadata file name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep index references limited to stable, canonical docs; omit experimental paths from the public metadata unless intentionally released."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure the skill description, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", and journey scope match the actual product journeys and feature coverage."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm required frontmatter keys exist."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm required sections are present (or intentionally omitted with justification)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the skill is journey-first and asks for the exact flow before implementation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm all source-doc links reach published pages and match the intended product docs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the examples match the actual documented request schema, not a guessed or simplified shape."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm any included feature docs are stable and publicly supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_updated"]}," to the current date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"formatting-rules","__idx":12},"children":["Formatting Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use concise headings and short bullet lists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use fenced code blocks for request examples."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep terminology consistent with the product docs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve existing tone/style used by other skill files in this repository."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"completion-checklist","__idx":13},"children":["Completion Checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before finishing changes to any ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/static/.well-known/skills/**/SKILL.md"]}," file:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.owner"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.last_updated"]}," exist and the metadata values are strings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm required sections are present (or intentionally omitted with justification)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the skill is journey-first and asks for the exact flow before implementation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm all source-doc links reach published pages and match the intended product docs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the examples match the actual documented request schema, not a guessed or simplified shape."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm any included feature docs are stable and publicly supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_updated"]}," to the current date."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before finishing any skill change, also confirm:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the metadata and root manifest match the published skill scope"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the public URL layout is root-relative and correct"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the skill is intentionally limited to stable, supported product journeys"]}]}]},"headings":[{"value":"Skills Authoring and Publishing Instructions","id":"skills-authoring-and-publishing-instructions","depth":1},{"value":"Scope","id":"scope","depth":2},{"value":"Objective","id":"objective","depth":2},{"value":"Required Workflow For New Skills","id":"required-workflow-for-new-skills","depth":2},{"value":"Required Section Structure","id":"required-section-structure","depth":2},{"value":"Required Frontmatter","id":"required-frontmatter","depth":2},{"value":"Writing Rules","id":"writing-rules","depth":2},{"value":"Reusable Skill Pattern","id":"reusable-skill-pattern","depth":2},{"value":"Content Quality Rules","id":"content-quality-rules","depth":2},{"value":"Publishing and Metadata Rules","id":"publishing-and-metadata-rules","depth":2},{"value":"Documentation Alignment","id":"documentation-alignment","depth":2},{"value":"Validation Checklist (Always Run)","id":"validation-checklist-always-run","depth":2},{"value":"Formatting Rules","id":"formatting-rules","depth":2},{"value":"Completion Checklist","id":"completion-checklist","depth":2}],"frontmatter":{"applyTo":"static/.well-known/skills/**, static/.well-known/skills/**/*.json","seo":{"title":"Skills Authoring and Publishing Instructions"}},"lastModified":"2026-10-01T15:06:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/.github/instructions/skill-authoring.instructions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}