Public Agent Skills
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
- 256 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The install script copies and overwrites folders in the agents' home skill directories
- Some skills drive a browser, a simulator and a Git repository, and the rollback skill runs `git reset --hard`
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/public-agent-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The install script copies and overwrites folders in the agents' home skill directories
- Some skills drive a browser, a simulator and a Git repository, and the rollback skill runs `git reset --hard`
This is third-party code. Review the repository files before installing.
What it does
The repository collects skills the author uses daily. The project management section opens with the `guide` skill, which runs development from a spec and a log with the subcommands `/guide load`, `/guide spec`, `/guide handoff`, `/guide test` and `/guide log`. Next to it are `aop-product-planner` for breaking down requirements by aspect, `cafe-whatabout` for a short project summary from Obsidian notes and a skill for organising project design decisions. The tools section holds `learning-assistant` for interactive study of a topic, `wx-emoji-maker` for 240×240 pixel WeChat stickers and `icns-maker` for macOS icons. For development the author added `git-snapshot-rollback`: before `git reset --hard` the skill saves the state to an archive branch and records links in `ARCHIVE.md`. `interactive-human-review` walks the user through a large change with questions and a checklist. Heavy third-party suites are packed as composite skills: `hyperframes`, `openslide`, `blender-skills` and `impeccable` sit behind one entry with a routing table, and sub-skills are read only when needed. That keeps dozens of descriptions out of the initial context. The `link_skills.py` script copies the chosen skills to `~/.agents/skills` and other skill directories.
Who it is for. Developers who work with several agents and want a ready set of everyday skills and an example of packing large third-party suites compactly.
Good fit when
- Before a rollback with `git reset --hard` you need to save the current state to an archive branch with a recorded reason
- A project runs from a spec and a log and the agent needs commands to load context, hand off work and write the log
- After a large agent edit you want to go through what changed and why, step by step, and test your understanding with questions
- Several heavy skill suites clutter the skill list and need to be hidden behind one entry
Not a fit when
- You need one skill for a narrow task: the collection is personal and many skills reflect the author's habits
- You need the current version of third-party suites like impeccable: the collection holds a repacked copy and fresh changes come from the original
- The environment has no Python: installation runs through the `link_skills.py` script
- You need an interface language other than Chinese: skill descriptions and documentation are in Chinese
Example request
Use the git-snapshot-rollback skill: save the current state to an archive branch and only then reset main to the previous commitLimitations
- The author warns that many skills are personal and may not suit others. Read all skill documents and code before installing.
- Installation runs through `link_skills.py`: it copies folders into `~/.agents/skills`, `~/.claude` and `~/.gemini/config/skills` and asks before overwriting changed files.
- Some skills sit in the `skills_parked/` directory and are not part of the main list.
- Third-party suites (`hyperframes`, `openslide`, `blender-skills`, `impeccable`, `agent-browser`) are repacked, with sources named in the description.
- The documentation is in Chinese.
How to disable. Delete the unwanted skill folders from `~/.agents/skills`, `~/.claude/skills` and `~/.gemini/config/skills`, then the `agents.md` file the script created next to them. The repository clone can be deleted entirely.
FAQ
How do I install the collection's skills?
Clone the repository and run `python3 link_skills.py`. The script finds `~/.agents`, `~/.claude` and `~/.gemini/config` and syncs the skill folders there, asking before overwriting changes.
What is a composite skill?
One entry skill for a large suite. Sub-skills live in `subskills/`, and the routing table in the top `SKILL.md` decides which one to read for a task.
How does git-snapshot-rollback work?
Before `git reset --hard` the skill snapshots the current state to an archive branch and records two-way links in `ARCHIVE.md`, so the rollback can be traced later.
Which third-party suites are included?
`hyperframes`, `openslide`, `blender-skills` and `impeccable` as composite skills, plus `agent-browser` from Vercel Labs. Each source is named in the README.
Is it safe to install all the skills?
The author advises reading all skill documents and code before installing, since a skill is prompts and scripts. Install the ones you need one by one instead of the whole collection.
Discussion
No questions or reviews yet.
Related
SkillsTwenty-two standalone skills: Notion, Todoist, Tavily, Context7, image generation, converting documents to Markdown
A personal library of 25 skills: posters and storyboards, Google-style code review, lab report reading and scenario simulations
Seven skills for research, HTML explainers and source citation, installable all at once or one at a time through npx.
A personal set of six skills: goal briefs for an agent, disk cleanup, AI news digests, project tidy-up, deep research and long-form writing
A library of 229 skills for work and life: sales, marketing, finance, engineering, design and parallel agent runs
Ten ShareAI Lab skills: source-level architecture research, review of past agent sessions, meeting coaching and article adaptation
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Public Agent Skills (this card) | no | 256 | |
| my-skills by akitaonrails | no | 292 | another author's personal skills with a different set of tasks |
| Sleek Agent Skills | no | 597 | skills of a single service, while this collection gathers general everyday skills |
README in short
The Chinese notes warn that the skills are personal, explain how big suites are packed as composite skills and give installation by script and by a link for the agent. A list of skills by section follows: project management, tools, development, repository work and content writing.
README badge
Original SKILL.md
---
name: guide
description: 基于规范驱动与日志记录的轻量级人机协作项目开发与管理方案，包含 /guide load, /guide spec, /guide handoff, /guide test, /guide log 子命令。
license: Apache-2.0
author: github/cafe3310
depends_on_skill: []
depends_on_binary: []
---
# Skill: guide
## 1. 概述
文档驱动、日志记录的人机协作开发工作流。用户控制开发节奏，Agent 负责文档撰写、任务拆分、开发执行和日志记录。
## 2. 概念定义
以下为默认路径和命名约定。项目章程有特别约定时，以项目章程为准。
- `文档目录`: 默认为项目根目录下 `backlog/`，存放需求、设计、日志等文档
- `规范目录`: 默认为 `{文档目录}/specifications/`，存放项目中长期生效的系统架构、数据契约、开发范式与全局禁忌规范
- `TODO 文件`: 默认项目根目录下 `TODO.md`
- `测试目录`: 默认项目根目录下 `tests/`
- `文档命名`: `YYYY-MM-DD-HH-mm-{类别}-{标题}.md`
- `测试用例集命名`: `tests/{YYYY-MM-DD-HH-mm}-testsuite/`
- `测试用例命名`: `part{序号}-{模块}/case{序号}-{简述}.md`，在测试用例集内部
## 3. 文档类别和编写风格
除了后面的工作流之外，若用户要求，Agent 可以随时写文档。
文档命名中的 `{类别}` 按以下分类取值：
- `开发日志`: 开发过程、决策、问题及解决方式的记录。
- `需求`: 用户想要实现的功能或目标。仅含需求本身，不含实现细节。
- `设计`: 对即将实施任务的提前分析。子类别：`系统设计`、`架构设计`、`交互设计`、`需求设计`。
- `规范`: 定义广泛适用的规则、流程或标准。子类别：`架构规范`、`代码规范`、`流程规范`。
- `说明`: 对已完成技术实体的使用说明。子类别：`接口说明`、`模块说明`。
- `调研`: 对外部技术或资料的研究与对比分析。广泛搜索，记录来源，写出细节而非过度摘要。
- `参考`: 从外部摘录的原始资料。与调研的区别在于侧重原样引用而非主动分析。
文档的主要读者是未来的 Agent 和开发者。所有文档、过程日志与说明均保持精简、克制、平和、去形容词、去比喻化。无需冗长描述。记录人类决策、问题和修正方案。提供检索和理解所需的最小说明即可。
当用户指示或流程需要进行互联网调研时：广泛搜索相关资料；每找到一份资料，即记录为一份独立的调研文档，按命名约定命名；文档要记录来源，写出方案、观点、方法的细节，不要过度摘要。
## 4. Subcommands