重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
sveltia-cms by secondsky/claude-skills
npx skills add https://github.com/secondsky/claude-skills --skill sveltia-cms用于将 Sveltia CMS 集成到静态站点项目的完整技能。
Sveltia CMS 是一个基于 Git 的轻量级无头内容管理系统,作为 Decap CMS(前身为 Netlify CMS)的现代继任者从头构建。它为存储在 Git 仓库中的内容提供了一个快速、直观的编辑界面。
* 捆绑包大小:<500 KB(压缩/Brotli 压缩),而竞争对手为 1.5-2.6 MB
* 使用 Svelte 编译器构建(无虚拟 DOM 开销)
* 使用 GraphQL API 实现即时内容获取
* 跨所有内容进行基于相关性的搜索
2. 现代用户体验
* 直观的管理界面,充分利用视口
* 支持深色模式(遵循系统偏好)
* 针对移动设备和平板电脑优化
* 支持多文件拖放上传
* 实时预览,即时更新
3. Git 原生架构
* 内容存储为 Markdown、MDX、YAML、TOML 或 JSON
* 完整的版本控制和变更历史
* 无供应商锁定 - 内容与代码共存
* 支持 GitHub、GitLab、Gitea、Forgejo 后端
4. 框架无关
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
* 作为原生 JavaScript 捆绑包提供
* 适用于 Hugo、Jekyll、11ty、Gatsby、Astro、Next.js、SvelteKit
* 无需 React、Vue 或框架运行时依赖
* 兼容任何静态站点生成器
5. 一流的国际化支持
* 内置多语言支持
* 一键集成 DeepL 翻译
* 编辑时切换语言环境
* 灵活的 i18n 结构(文件、文件夹、单文件)
6. 内置图像优化
* 自动 WebP 转换
* 客户端调整大小和优化
* 支持 SVG 优化
* 可配置的质量和尺寸
* Hugo 博客和文档
* Jekyll 站点和 GitHub Pages
* 11ty (Eleventy) 项目
* Gatsby 营销站点
* Astro 内容密集型站点
2. 非技术编辑人员需要访问权限
* 管理页面的营销团队
* 撰写博客文章的作者
* 不了解 Git 的内容团队
* 需要轻松更新内容的客户
3. 期望基于 Git 的工作流
* 通过 Git 进行内容版本控制
* 通过拉取请求进行内容审核
* 内容与代码共存于仓库中
* 用于部署的 CI/CD 集成
4. 需要轻量级解决方案
* 对性能敏感的项目
* 需要移动优先的编辑体验
* 快速加载时间至关重要
* 最小的捆绑包大小很重要
5. 从 Decap/Netlify CMS 迁移
* 现有的 config.yml 可以重用
* 直接替换(只需更改 1 行)
* 更好的性能和用户体验
* 积极的维护和错误修复
* 多个用户同时编辑(类似 Google Docs 风格)
* 请改用 Sanity、Contentful 或 TinaCMS
2. 需要可视化页面构建
* 需要拖放式页面构建器
* 请改用 Webflow、Builder.io 或 TinaCMS (React)
3. 高度动态的数据
* 具有实时库存的电子商务
* 实时仪表板或分析
* 请改用传统数据库(D1、PostgreSQL)
4. 需要 React 特定的可视化编辑
* 上下文内组件编辑
* 请改用 TinaCMS(专注于 React)
使用 Sveltia 适用于:
使用 TinaCMS 适用于:
两者都有效 - Sveltia 与 TinaCMS 在不同用例上形成互补。
加载 references/framework-setup.md 以获取特定框架的完整设置说明(Hugo、Jekyll、11ty、Astro、Next.js、Gatsby、SvelteKit)。
static/admin、public/admin)admin/index.html 并包含 Sveltia CMS 脚本标签admin/config.yml 并配置后端和集合references/authentication-guide.md/admin/ 在本地测试模板 可在 templates/ 目录中找到,适用于每个框架。
加载 references/authentication-guide.md 以获取完整的 OAuth 设置说明。
| 方法 | 最适合 | 复杂度 |
|---|---|---|
| Cloudflare Workers | 所有部署 | 简单 ⭐ |
| Vercel Serverless | Vercel 项目 | 中等 |
| 本地开发 | 仅开发环境 | 简单 |
推荐 : Cloudflare Workers OAuth(官方、快速、免费)
模板 : 参见 templates/cloudflare-workers/ 和 templates/vercel-serverless/
加载 references/configuration-guide.md 以获取完整的 config.yml 文档、集合模式和 i18n 设置说明。
backend:
name: github
repo: owner/repo
branch: main
base_url: https://your-worker.workers.dev
media_folder: static/images
public_folder: /images
collections:
- name: posts
label: Blog Posts
folder: content/posts
create: true
fields:
- { label: Title, name: title, widget: string }
- { label: Body, name: body, widget: markdown }
集合模板 可在 templates/collections/ 中找到,适用于博客、文档和落地页。
i18n 支持 : 多文件、文件夹或单文件结构 - 参见参考指南。
此技能可预防 8 种常见错误。下方显示前 3 种 - 加载 references/error-catalog.md 以获取所有 8 种错误的完整解决方案。
错误 : "Error: Failed to authenticate" / 重定向到错误的域名
快速修复:
config.yml 中的 base_url 指向你的 OAuth 代理curl https://your-worker.workers.dev/health→ 加载 references/error-catalog.md 错误 #1 获取完整解决方案
错误 : "No entries found" / 内容列表为空
快速修复:
folder 路径与实际文件位置匹配format 与实际文件格式匹配(yaml 与 toml)→ 加载 references/error-catalog.md 错误 #4 获取完整解决方案
错误 : "Authentication Aborted" / OAuth 弹窗关闭
快速修复:
Cross-Origin-Opener-Policy: same-origin-allow-popupsconnect-src 指令中→ 加载 references/error-catalog.md 错误 #8 获取完整解决方案
所有 8 种错误及详细解决方案: 参见 references/error-catalog.md
Sveltia 是一个直接替换方案 - 只需更改脚本标签!
<!-- OLD: Decap CMS -->
<script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
<!-- NEW: Sveltia CMS -->
<script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script>
你现有的 config.yml 可以直接使用。加载 references/migration-from-decap.md 以获取完整的迁移指南和测试清单。
加载 references/deployment-guide.md 以获取特定平台的部署说明(Cloudflare Pages、Vercel、Netlify、GitHub Pages)。
config.yml 中设置了 base_url/admin/ 路由加载 references/framework-setup.md 当:
加载 references/authentication-guide.md 当:
base_url 配置加载 references/configuration-guide.md 当:
config.yml 示例加载 references/error-catalog.md 当:
加载 references/deployment-guide.md 当:
加载 references/migration-from-decap.md 当:
模板 : templates/hugo/、templates/jekyll/、templates/cloudflare-workers/ 官方文档 : https://github.com/sveltia/sveltia-cms OAuth Worker : https://github.com/sveltia/sveltia-cms-auth
当前版本 : @sveltia/cms@0.113.5 (2025年10月) 状态 : 可用于生产环境,v1.0 预计 2026 年初
最后更新 : 2025-10-24
每周安装量
65
代码仓库
GitHub 星标数
93
首次出现
2026年2月6日
安全审计
安装在
claude-code60
gemini-cli55
opencode53
cursor53
codex52
github-copilot51
Complete skill for integrating Sveltia CMS into static site projects.
Sveltia CMS is a Git-based lightweight headless content management system built from scratch as the modern successor to Decap CMS (formerly Netlify CMS). It provides a fast, intuitive editing interface for content stored in Git repositories.
Lightweight & Fast
Modern User Experience
Git-Native Architecture
Framework-Agnostic
First-Class Internationalization
Built-In Image Optimization
Building Static Sites
Non-Technical Editors Need Access
Git-Based Workflow Desired
Lightweight Solution Required
Migrating from Decap/Netlify CMS
Real-Time Collaboration Needed
Visual Page Building Required
Highly Dynamic Data
React-Specific Visual Editing Needed
Use Sveltia for:
Use TinaCMS for:
Both are valid - Sveltia complements TinaCMS for different use cases.
Loadreferences/framework-setup.md for complete framework-specific setup (Hugo, Jekyll, 11ty, Astro, Next.js, Gatsby, SvelteKit).
static/admin, public/admin)admin/index.html with Sveltia CMS script tagadmin/config.yml with backend and collectionsreferences/authentication-guide.md/admin/Templates available in templates/ directory for each framework.
Loadreferences/authentication-guide.md for complete OAuth setup instructions.
| Method | Best For | Complexity |
|---|---|---|
| Cloudflare Workers | All deployments | Easy ⭐ |
| Vercel Serverless | Vercel projects | Medium |
| Local Development | Dev only | Easy |
Recommended : Cloudflare Workers OAuth (official, fast, free)
Templates : See templates/cloudflare-workers/ and templates/vercel-serverless/
Loadreferences/configuration-guide.md for complete config.yml documentation, collection patterns, and i18n setup.
backend:
name: github
repo: owner/repo
branch: main
base_url: https://your-worker.workers.dev
media_folder: static/images
public_folder: /images
collections:
- name: posts
label: Blog Posts
folder: content/posts
create: true
fields:
- { label: Title, name: title, widget: string }
- { label: Body, name: body, widget: markdown }
Collection templates available in templates/collections/ for blogs, docs, and landing pages.
i18n support : Multiple files, folders, or single file structures - see reference guide.
This skill prevents 8 common errors. Top 3 shown below - loadreferences/error-catalog.md for all 8 with complete solutions.
Error : "Error: Failed to authenticate" / redirects to wrong domain
Quick Fix:
base_url in config.yml points to your OAuth proxycurl https://your-worker.workers.dev/health→ Loadreferences/error-catalog.md Error #1 for complete solution
Error : "No entries found" / empty content list
Quick Fix:
folder path matches actual file locationformat to actual file format (yaml vs toml)→ Loadreferences/error-catalog.md Error #4 for complete solution
Error : "Authentication Aborted" / OAuth popup closes
Quick Fix:
Cross-Origin-Opener-Policy: same-origin-allow-popups in headersconnect-src→ Loadreferences/error-catalog.md Error #8 for complete solution
All 8 errors with detailed solutions: See references/error-catalog.md
Sveltia is a drop-in replacement - just change the script tag!
<!-- OLD: Decap CMS -->
<script src="https://unpkg.com/decap-cms@^3.0.0/dist/decap-cms.js"></script>
<!-- NEW: Sveltia CMS -->
<script src="https://unpkg.com/@sveltia/cms/dist/sveltia-cms.js" type="module"></script>
Your existing config.yml works as-is. Loadreferences/migration-from-decap.md for complete migration guide and testing checklist.
Loadreferences/deployment-guide.md for platform-specific deployment instructions (Cloudflare Pages, Vercel, Netlify, GitHub Pages).
base_url set in config.yml/admin/ route after deploymentLoadreferences/framework-setup.md when:
Loadreferences/authentication-guide.md when:
base_url configurationLoadreferences/configuration-guide.md when:
config.yml examplesLoadreferences/error-catalog.md when:
Loadreferences/deployment-guide.md when:
Loadreferences/migration-from-decap.md when:
Templates : templates/hugo/, templates/jekyll/, templates/cloudflare-workers/ Official Docs : https://github.com/sveltia/sveltia-cms OAuth Worker : https://github.com/sveltia/sveltia-cms-auth
Current Version : @sveltia/cms@0.113.5 (October 2025) Status : Production-ready, v1.0 expected early 2026
Last Updated : 2025-10-24
Weekly Installs
65
Repository
GitHub Stars
93
First Seen
Feb 6, 2026
Security Audits
Gen Agent Trust HubFailSocketPassSnykWarn
Installed on
claude-code60
gemini-cli55
opencode53
cursor53
codex52
github-copilot51
SvelteKit远程函数库:简化服务器端逻辑调用与数据验证
210 周安装
agent-browser 浏览器自动化工具:命令行网页操作与测试指南
500 周安装
index-knowledge:自动生成层级化AGENTS.md文档工具,Turso数据库出品
496 周安装
Context7自动研究技能:为Claude Code自动获取最新库框架文档
493 周安装
Next.js React 依赖内嵌指南:App Router 配置、类型声明与 Turbopack 映射
519 周安装
TikTok标题与脚本生成器 - 提升SEO、观看时长和可访问性的视频创作工具
503 周安装
Nx Cloud CI 监控与自愈修复工具 - monitor-ci 自动化流水线协调器
500 周安装