stamic-skill (Statamic 6 Dev)

Workflow (recommended)

1. Clarify target + context
   • Confirm: Statamic 6 (and Laravel version), project type (fresh vs existing), and whether the request is Statamic-specific (content model, Antlers, blueprints, structures) vs Laravel-specific (DB, Eloquent, queues, debugging).
2. Prefer canonical docs, but keep it searchable
   • Ensure the local docs mirror exists before searching:
     bash

     ./scripts/update_statamic_docs.sh

   • If you need parallel searches, do this:
     1. Bootstrap once with

        ./scripts/update_statamic_docs.sh --docs-dir <shared-path>

        .
     2. Run parallel

        search_statamic_docs.sh

        calls with the same

        --docs-dir <shared-path>

        and

        --no-bootstrap

        .
   • Use statamic.dev for canonical explanations.
   • Use GitHub mirror (statamic/docs) for fast full-text search, diffs, and linking to exact Markdown.
   • If information conflicts, treat statamic.dev as source of truth and mention the discrepancy.
3. Search → quote → answer
   • Search for the relevant page/section.
   • Answer with short, actionable steps.
   • Include links (statamic.dev and/or specific docs file paths) so the team can verify.
4. Separate Statamic vs Laravel concerns
   • Use this skill for Statamic concepts and conventions (blueprints/fieldsets, entries, taxonomies, Antlers, tags/modifiers, Stache/cache, sites).
   • For Laravel framework mechanics (Artisan, Eloquent, queues, debugging, environment), rely on official Laravel documentation and project conventions.

What to do for common requests

“Find the latest docs for X”

• Search the GitHub mirror first (fast), then open the canonical statamic.dev page.
• Provide: the best page link, the key excerpt/summary, and 1–3 do/don’t bullets.

“How do we implement X in Statamic 6?”

• Return a minimal implementation plan + code/config snippets.
• Call out:
  • where files live (blueprints, templates, addons)
  • expected conventions/naming
  • caches to clear (when relevant)

“Is this best practice / is this supported in v6?”

• Confirm version explicitly.
• Prefer citing a doc section or a clear upstream source.

Bundled resources

references/

• references/sources.md

  : canonical sources and how to treat them.

• references/response-guidelines.md

  : domain taxonomy + response checklist for consistent Statamic 6 answers.

scripts/

1. Update/bootstrap local docs mirror (runtime-safe):

./scripts/update_statamic_docs.sh

./dev-scripts/update_statamic_docs.sh

1. Search locally:

./scripts/search_statamic_docs.sh "your query"

./scripts/update_statamic_docs.sh

--no-bootstrap

--rank-mode fzf

--rank-mode hybrid

--top

fzf

rg/grep

./scripts/update_statamic_docs.sh --docs-dir /tmp/statamic-docs-shared
./scripts/search_statamic_docs.sh --docs-dir /tmp/statamic-docs-shared --no-bootstrap --top 20 "antlers"

./scripts/search_statamic_docs.sh --top 20 "antlers"
./scripts/search_statamic_docs.sh --rank-mode hybrid --top 20 "assets container"