Coding
PromptBeginner5 minmarkdown
Markdown Converter
Agent skill for markdown-converter
7
Owner: ElPuas Digital Crafts
Sign in to like and favorite skills
Owner: ElPuas Digital Crafts
Project: ELPUAS.COM (Astro site on Netlify)
@font-facenpm run build, publishes /distastro.config.mjs: Site URL plus MDX, sitemap, React, Partytown integrationspackage.json: npm scripts (dev, build, preview, astro) and runtime deps (@astrojs packages, React, DatoCMS SDK)src/consts.ts: Shared metadata stringssrc/components/: UI building blocks (BaseHead, Hero variants, Article lists, navigation)src/layouts/: BaseLayout shell with GraphQL navigation fetch, blog layoutsrc/pages/: Route definitions; fetch DatoCMS content at build timesrc/queries/: Central GraphQL query strings grouped by featuresrc/utils/: fetchGraphQL helper and Structured Text renderersrc/scripts/menu.js: Handles mobile nav togglesrc/styles/: Global tokens and typography scalespublic/: Static assets, fonts, AI context file llms.txt.cursor/rules/: Prior AI guidance on content structure, deployment, and component patterns.env: Local DatoCMS token (never commit real keys)semi: false, useTabs: true, singleQuote: trueconst/let only, no varstrictNullChecks; leverage Astro's inferred types_modelApiKeysrc/styles, using custom properties and container queries instead of utility frameworkssrc/queriessrc/queries and export named constants in ALL_CAPSfetchGraphQL for API calls; include graceful error handling at call sites@datocms/astro/StructuredText and responsive media with @datocms/astro/Imagesrc/components; name files in PascalCase with .astropublic/; fonts load through BaseHeadpublic/llms.txt when context for assistants changeschore/agent-mdtype(scope): summary) for messagesnpm run astro for scaffolding or upgradesnpm run build to surface many integration issues.vscode and .cursornpm install then npm run dev (defaults to port 4321)npm run build, outputs to distnpm run preview to serve the built sitenpm run build, publish directory dist, Node 18 per existing docsDATOCMS_API_KEY for all build targets (available locally via .env, configure in Netlify UI)npm run build to catch Astro or GraphQL errorslets-talk), blog listing generationDATOCMS_API_KEY as secret; never hardcode or log values_modelApiKey, add query fields in src/queries, create component in src/components, render inside relevant page with prop validationsrc/styles if global, otherwise scope CSS inside component <style> blocks with container queries where usefulloading="lazy", configure allow attributes, and ensure responsive wrapper similar to VideoHeropublic/llms.txt and reflect any new automation guidance in this file and .cursor/rulesnpm run build if it fails.env stays ignored.logs/YYYY-MM-DD-repo-audit-and-agent-md.md (or similar task name) summarizing actions, key diffs, and next steps.cursor/rules/; consult alongside this guide for deep dives