Agent skill

gitsite-content-manager

自动管理 GitSite 静态网站生成器项目的 blogs、books 和 pages 内容。当用户需要创建博客文章、书籍章节、书籍或静态页面时使用此 skill。该 skill 会自动创建正确的目录结构、生成带有完整 frontmatter 的 Markdown 模板文件，并提供内容管理的 Python 脚本。适用于使用 GitSite CLI 构建的静态网站项目。

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/Orangon/Learning2Peak/tree/main/.claude/skills/gitsite-content-manager

SKILL.md

GitSite Content Manager

Overview

此 skill 专为使用 GitSite 静态网站生成器的项目设计，用于自动化管理网站内容（blogs、books 和 pages）。GitSite 使用特定的目录结构和 YAML 配置文件，每次手动创建内容时容易忘记正确的配置格式和文件位置。此 skill 确保内容创建的一致性和正确性。

Quick Start

当用户请求创建以下任何内容时，使用此 skill：

  • 创建新的博客文章
  • 创建新的书籍
  • 创建新的书籍章节
  • 创建新的静态页面

Content Creation Workflow

1. 创建博客文章 (Blog Post)

目录结构：

source/blogs/tech/
└── YYYY-MM-DD-post-slug/
    └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py blog \
  --title "My Blog Post Title" \
  --date "2025-01-15" \
  --description "A description of the post" \
  --tags tech tutorial \
  --author "Orangon"

手动创建步骤：

  1. 在 source/blogs/tech/ 下创建日期目录，格式：YYYY-MM-DD-title-slug/
  2. 创建 README.md 文件，包含以下 frontmatter：
yaml
---
title: "Blog Post Title"
date: 2025-01-15
description: "Blog post description"
tags:
  - tech
  - tutorial
author: Orangon
---

# Blog Post Title

<!-- Write your blog post content here -->

## Introduction

<!-- Add your introduction -->

## Main Content

<!-- Add your main content -->

## Conclusion

<!-- Add your conclusion -->

2. 创建书籍 (Book)

目录结构：

source/books/
└── book-name/
    ├── book.yml
    ├── index.md
    └── 01-Chapter-One/
        └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py book \
  --name "My-Book" \
  --title "My Book Title" \
  --description "Book description" \
  --author "Orangon"

手动创建步骤：

  1. 在 source/books/ 下创建书籍目录
  2. 创建 book.yml 配置文件：
yaml
title: My Book Title
description: Book description
author: Orangon
  1. 创建 index.md 作为书籍索引页面

3. 创建书籍章节 (Book Chapter)

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py chapter \
  --book "My-Book" \
  --number "01" \
  --title "Chapter One" \
  --description "Chapter description"

手动创建步骤：

  1. 在书籍目录下创建章节目录，格式：XX-Chapter-Title/
  2. 创建 README.md 文件：
yaml
---
title: "Chapter One"
description: "Chapter description"
---

# 01. Chapter One

<!-- Write your chapter content here -->

## Overview

<!-- Add chapter overview -->

## Main Content

<!-- Add your main content -->

## Summary

<!-- Add chapter summary -->

## References

<!-- Add references if needed -->

4. 创建静态页面 (Page)

目录结构：

source/pages/
└── page-name/
    └── README.md

使用 Python 脚本创建：

bash
python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py page \
  --name "about" \
  --title "About Us" \
  --description "About page description"

手动创建步骤：

  1. 在 source/pages/ 下创建页面目录
  2. 创建 README.md 文件：
yaml
---
title: "About Us"
description: "About page description"
---

# About Us

<!-- Write your page content here -->

Templates

使用 assets/templates/ 中的模板文件作为内容创建的基础：

  • blog_post.md - 博客文章模板
  • book_chapter.md - 书籍章节模板
  • page.md - 静态页面模板

这些模板包含完整的 frontmatter 结构和内容大纲。

Important Notes

目录命名规范

  1. 博客文章：使用日期格式 YYYY-MM-DD-title-slug/
  2. 书籍章节：使用编号前缀 XX-Chapter-Title/ (如 01-Introduction/)
  3. 书籍目录：使用 kebab-case 命名 (如 AI-Coding/)
  4. 页面目录：使用 kebab-case 命名 (如 about-me/)

Frontmatter 格式

所有内容文件必须包含 YAML frontmatter，基本格式：

yaml
---
title: "Content Title"
description: "Content description"
---

博客文章额外需要：

  • date: 发布日期
  • tags: 标签列表
  • author: 作者名称

配置文件位置

  • 网站配置：source/site.yml (主配置)
  • 博客配置：source/blogs/tech/blog.yml
  • 书籍配置：source/books/[book-name]/book.yml
  • 页面配置：无需单独配置文件

URL 生成规则

GitSite 自动根据目录结构生成 URL：

  • 博客：/blogs/tech/YYYY-MM-DD-title-slug/index.html
  • 书籍：/books/book-name/XX-Chapter-Title/index.html
  • 页面：/pages/page-name/index.html

Verification

创建内容后，验证构建是否成功：

bash
# 构建网站
gitsite-cli build -o _site -v

# 或启动开发服务器预览
gitsite-cli serve

检查生成的 HTML 文件是否存在于 _site/ 目录中。

Common Pitfalls

  1. 忘记创建 book.yml：书籍目录必须有 book.yml 配置文件
  2. 目录命名错误：使用空格或特殊字符会导致构建失败
  3. 缺少 README.md：每个内容目录必须有 README.md 文件
  4. Frontmatter 格式错误：YAML 格式必须正确，注意引号和缩进
  5. 日期格式错误：博客日期必须使用 YYYY-MM-DD 格式

Resources

scripts/manage_content.py

Python 脚本提供命令行接口用于创建各种类型的内容。支持以下命令：

  • blog - 创建博客文章
  • book - 创建书籍
  • chapter - 创建书籍章节
  • page - 创建静态页面

使用 --help 查看完整参数说明。

assets/templates/

包含各类内容模板文件，可直接复制使用或作为参考：

  • blog_post.md - 完整的博客文章模板
  • book_chapter.md - 完整的书籍章节模板
  • page.md - 完整的静态页面模板

模板文件使用 {{variable}} 占位符，使用时需要替换为实际内容。

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Orangon/Learning2Peak

notebooklm-ppt-designer

国际一流PPT设计架构师，将内容素材（讲稿/主题词/大纲）转化为可直接执行的PPT设计方案。适用于：(1) 根据演讲稿生成PPT设计提示词，(2) 将主题词扩展为完整PPT设计方案，(3) 为内容大纲选择最佳视觉形式，(4) 生成符合品牌视觉规范的设计参数，(5) 输出Gamma Pro等工具可用的生成指令。当用户提及"PPT设计"、"演示文稿"、"幻灯片"、"presentation"、"slides"、"设计方案"、"NotebookLM"、"Gamma"、"Keynote风格"等关键词时触发。

0 0
Explore
mattpocock/skills

git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore
mattpocock/skills

scaffold-exercises

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

111,310 9,758
Explore
mattpocock/skills

edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results