Coast AI Skills
coastdigitalgroup/coastai-skills
Skill library portátil para agentes IA via MCP server
Ver no GitHubBiblioteca portável de skills servida como MCP server que permite agentes IA acessarem orientações estruturadas para design, desenvolvimento e crescimento de websites. Integra-se nativamente com Claude, Cursor, Windsurf e outros editores sem duplicação de arquivos.
Instalação
npx convez-ai coastdigitalgroup/coastai-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Fornecer guias reutilizáveis de design web aos agentes IA
- Centralizar workflows de desenvolvimento em múltiplos editores
- Buscar e recuperar skills estruturadas sob demanda
Veredito

Solução robusta e bem-pensada para compartilhar conhecimento estruturado com agentes IA. Destaca-se pela simplicidade de instalação, integração cross-editor e abordagem de skills como Markdown portável em vez de código injetado.
README
A tradução para o português deste README ainda está na fila.
@coastdigitalgroup/coastai-skills
A portable, agent-friendly skill library served as an MCP server. Drop it into any project and AI agents across Codex, Claude Code, Cursor, Windsurf, Zed, and Continue instantly have access to structured guidance for website design, development, and growth tasks — without copying a single file.
At a glance
- What this is: An MCP package that serves portable
SKILL.mdcontent to AI agents on demand. - Who it is for: Teams using AI coding/design agents that need reusable website design, development, and growth workflows.
- What this package owns: Skill discovery, skill search, and skill retrieval over three MCP tools.
- What this package does not own: Application runtime logic, framework scaffolding, or replacing your product architecture.
When to use this package
- You want AI agents to discover and apply reusable skills by topic.
- You want one shared skill library across editors and agent runtimes.
- You want a thin MCP layer with most value kept in portable Markdown skills.
When not to use this package
- You need a web framework starter or full application boilerplate.
- You need a domain-specific business app instead of a reusable skill library.
- You want dynamic runtime orchestration beyond skill lookup and retrieval.
Contributing | Changelog | Security
Install
Run once in any project directory:
npx @coastdigitalgroup/coastai-skills --install
The installer auto-detects every supported editor on the machine, writes the MCP
server entry into each config, and adds a CLAUDE.md instruction so agents know
to use skills automatically. Restart your editor and it is live.
How it works
The MCP server exposes three tools agents call on demand:
| Tool | What it does |
|---|---|
search_skills(query) | Finds relevant skills by keyword — use this first |
list_skills(category?) | Browses all skills, optionally filtered by category |
get_skill(name) | Loads the full skill content by exact name |
Typical agent flow:
User: "Help me build an accessible modal dialog"
Agent: search_skills("modal dialog accessible")
→ accessible-modal-dialog (website-development)
Agent: get_skill("accessible-modal-dialog")
→ full workflow, decision rules, validation steps
Agent: executes with skill guidance
Skills are never injected into context upfront. The agent fetches exactly what it needs, when it needs it.
Package contract
Runtime interface
| Surface | Contract |
|---|---|
| CLI binary | coastai-skills (published from dist/index.js) |
| Install mode | coastai-skills --install auto-configures supported editors |
| Server mode | coastai-skills runs MCP over stdio |
| MCP tools | search_skills, list_skills, get_skill |
This package is CLI-first. There is no documented stable JavaScript API.
Source-of-truth and edit boundaries
- Source-of-truth: Skill content in
/<category>/<skill-name>/SKILL.mdand discovery behavior insrc/skills.ts. - Generated output:
dist/is build output and should not be hand-edited for routine changes. - Protected boundaries: Keep
src/as a thin transport/discovery layer and avoid moving execution logic out of skills. - Unsafe direct edits: Do not hand-edit packaged artifacts for release behavior changes; update source and rebuild instead.
AI boundaries snapshot
CLAUDE.md: lead implementation authority.CODEX.md: release-readiness, docs consistency, stabilization, and validation stewardship.COPILOT.md: IDE support guidance.JULES.md: bounded automation and micro-maintenance.AGENTS.md: shared coordination and ownership boundaries.
Supported editors
| Editor | Auto-configured |
|---|---|
| Codex | ✓ |
| Claude Code | ✓ |
| Claude Desktop (macOS + Windows) | ✓ |
| Cursor (project + global) | ✓ |
| Windsurf | ✓ |
| Zed (macOS + Linux) | ✓ |
| Continue | ✓ |
Available skills
The package currently includes 217 validated skills across three categories.
Use list_skills for the current runtime catalogue and get_skill(name) for
the full execution guidance.
website-design (73 skills)
accessible-color-systemaccordion-ui-systemarticle-layout-systembadge-and-tag-systembanner-and-alert-systembento-grid-layout-systembreadcrumb-wayfinding-systembutton-and-action-systemcalendar-and-date-systemcard-ui-systemcarousel-and-slider-systemcommand-palette-systemcomment-and-discussion-systemcomparison-matrix-systemconsent-and-preference-systemconversational-chat-ui-systemcustom-select-and-combobox-systemdark-theme-design-systemdashboard-layout-systemdata-table-ui-systemdata-visualization-systemelevation-and-depth-systemempty-state-systemerror-and-status-systemfile-upload-management-systemfilter-and-sort-systemfluid-spacing-systemfluid-typography-systemfocus-indicator-design-systemform-design-systemhero-design-systemiconography-systemimage-comparison-slider-systemimage-gallery-and-lightbox-systemimagery-and-media-systeminteractive-state-systeminterface-motion-systeminternationalization-design-systemkanban-board-ui-systemlogo-grid-systemmaster-detail-layout-systemmetric-and-statistic-systemnotification-center-systemonboarding-tour-systemoverlay-and-dialog-systempage-header-systempagination-systempricing-table-ui-systemproduct-detail-layout-systemproperty-and-attribute-systemresponsive-grid-systemreview-and-rating-systemsearch-interface-systemsection-composition-systemsegmented-control-systemsettings-interface-systemshopping-cart-ui-systemsidebar-navigation-systemsite-footer-systemsite-navigation-systemskeleton-state-systemstep-progress-systemsticky-and-floating-ui-systemstore-locator-systemtab-ui-systemtable-of-contents-systemtestimonial-and-quote-systemtimeline-activity-systemtoast-and-snackbar-systemtooltip-and-hint-systemtree-view-navigation-systemuser-avatar-systemvisual-hierarchy-system
website-development (75 skills)
accessible-accordion-implementationaccessible-audio-player-implementationaccessible-bottom-sheet-implementationaccessible-breadcrumb-implementationaccessible-carousel-implementationaccessible-combobox-implementationaccessible-context-menu-implementationaccessible-date-picker-implementationaccessible-drag-and-drop-listaccessible-file-upload-implementationaccessible-modal-dialogaccessible-multi-select-tag-inputaccessible-pagination-implementationaccessible-password-field-implementationaccessible-range-slider-implementationaccessible-split-pane-implementationaccessible-star-rating-implementationaccessible-switch-implementationaccessible-tabs-implementationaccessible-toast-implementationaccessible-tooltip-implementationaccessible-tree-view-implementationadaptive-loadingbfcache-optimizationbody-scroll-lock-implementationclient-side-idle-detectionclient-side-image-compressionclient-side-storage-managementcontainer-queries-implementationcopy-to-clipboard-implementationcss-anchor-positioning-implementationcss-cascade-layerscss-grid-layout-implementationcss-stacking-contextscumulative-layout-shift-mitigationdark-mode-implementationdynamic-text-truncationfetch-race-condition-managementfluid-typography-and-spacingfocus-visible-styling-systemfocus-management-client-side-navigationfocus-trap-implementationhigh-contrast-forced-colors-implementationhigh-performance-css-animationsinfinite-scroll-implementationinput-masking-and-formattinginteraction-performance-optimizationkeyboard-shortcut-implementationlazy-loading-implementationmobile-viewport-implementationmulti-step-form-implementationnative-video-implementationpopover-api-implementationprint-style-optimizationresource-prioritization-strategyresponsive-data-tablesresponsive-imagesresponsive-navigation-implementationrobust-form-implementationrtl-layout-implementationscroll-driven-animations-implementationscroll-reveal-implementationscrollbar-layout-shift-preventionservice-worker-offline-and-cache-managementskeleton-screen-implementationsticky-element-implementationsvg-optimization-implementationtable-of-contents-implementationtext-zoom-and-resize-resiliencethird-party-embed-optimizationurl-state-synchronizationview-transitions-implementationvirtual-list-implementationweb-font-optimizationweb-worker-implementation
website-growth (69 skills)
404-page-recoveryabm-personalization-optimizationabout-us-page-optimizationannouncement-bar-optimizationapp-download-optimizationbilling-interval-optimizationbundle-optimizationbuy-now-pay-later-optimizationcart-experience-optimizationcheckout-flow-optimizationcheckout-order-bump-optimizationcheckout-payment-decline-optimizationchurn-prevention-flow-optimizationco-branded-landing-page-optimizationcompetitor-comparison-optimizationcontact-page-optimizationcontextual-cta-optimizationconversational-conversion-optimizationcookie-consent-optimizationcustomer-case-study-optimizationdiscount-and-coupon-optimizationenterprise-trust-center-optimizationexit-intent-recoveryfaq-section-optimizationfree-shipping-threshold-optimizationgated-content-paywall-optimizationgift-with-purchase-optimizationguided-discovery-optimizationhero-section-optimizationinclusive-conversion-optimizationintegrations-directory-optimizationinteractive-demo-optimizationinternal-search-optimizationlanding-page-content-hierarchylead-capture-form-optimizationlead-magnet-optimizationlocalization-optimizationmeeting-scheduling-optimizationmessage-match-optimizationmicro-survey-optimizationmobile-conversion-optimizationobjection-handling-optimizationpost-conversion-momentumpost-purchase-cross-sell-optimizationpricing-page-optimizationproduct-listing-page-optimizationproduct-page-optimizationreferral-loop-optimizationrequest-for-quote-optimizationreturn-visitor-optimizationrisk-reversal-optimizationsearch-snippet-optimizationsecondary-cta-optimizationsize-guide-and-fit-optimizationsocial-auth-optimizationsocial-proof-optimizationstockout-recovery-optimizationsubscription-cancel-flow-optimizationtrial-to-paid-optimizationupsell-cross-sell-optimizationurgency-and-scarcity-optimizationuser-intent-alignmentuser-onboarding-optimizationvalue-calculator-optimizationvideo-conversion-optimizationvisual-hierarchy-and-scanning-patternswaitlist-prelaunch-optimizationwelcome-popup-optimizationwishlist-optimization
Adding skills
The library is domain-agnostic. Add any topic by dropping a folder into a category directory:
/<category>/<skill-name>/SKILL.md
Each SKILL.md requires a frontmatter block. The description is what agents
use to decide if a skill is relevant:
---
name: your-skill-name
description:
One or two sentences explaining what this skill does and when to trigger it.
Write it as if the agent is reading it to decide whether to load the skill.
---
The MCP server discovers new skills automatically — no code changes or rebuilds needed.
Optional support folders alongside SKILL.md:
examples/— worked examplestemplates/— reusable filesreferences/— detailed reference materialassets/— images or other static filesscripts/— deterministic helper scripts
Development
git clone https://github.com/coastdigitalgroup/coastai-skills.git
cd coastai-skills
npm install
npm run validate
| Command | What it does |
|---|---|
npm run build | Compiles TypeScript to dist/ |
npm run validate | Runs typecheck, lint, build, skill checks, and package checks |
npm run check:skills | Validates skill frontmatter, naming, and support-folder policy |
npm run check:package | Validates packability with npm pack --dry-run |
npm run typecheck | Type-check without emitting files |
npm run lint | ESLint over src/ |
npm run dev | Runs the MCP server directly via tsx |
The MCP server source lives in src/. Skills live in the category folders at
the repo root. They are independent — editing skills never requires a rebuild.
Validation and release notes
- Full validation gate:
npm run validate - Release process: follow
RELEASE.md - Release-facing history:
CHANGELOG.md
For src/, package, or tooling changes, run the full gate before handoff. For
skill-only or docs-only changes, validate frontmatter, links, naming, and
cross-doc consistency.
Local setup
git clone https://github.com/coastdigitalgroup/coastai-skills.git
cd coastai-skills
npm install
npm run validate
Troubleshooting
- No skills are found: confirm category folders are top-level directories
and each skill has
SKILL.mdwith validnameanddescriptionfrontmatter. - Validation fails on skills: run
npm run check:skillsand fix reported folder/frontmatter errors. - Editor does not detect the server after install: rerun
npx @coastdigitalgroup/coastai-skills --installand restart the editor. - Version mismatch in server metadata: update
package.json;src/server.tsreads version from package metadata.
Contributing
Contributions should prioritize portability, reuse, and execution quality over volume. Strengthen an existing skill before creating a near-duplicate.
See CONTRIBUTING.md for the full workflow, AGENT.md for repository structure and quality standards, AGENTS.md for shared agent coordination, CLAUDE.md for Claude Code implementation authority, CODEX.md for Codex release and review guidance, COPILOT.md for GitHub Copilot support guidance, JULES.md for Google Jules maintenance boundaries, and RELEASE.md for the release checklist.
GitHub Copilot support behavior is defined in .github/copilot-instructions.md.
License
MIT. See LICENSE.