Agent skill

Project Design Concept Organizer

by cafe3310 in cafe3310/public-agent-skills

补充 doc-todo-log-loop,在开发过程中归纳项目的设计理念和架构模式,将开发决策和隐性知识转化为系统的设计文档

Apache-2.0Auto-check passed

Install Project Design Concept Organizer

skills CLI
$ npx skills add cafe3310/public-agent-skills --skill project-design-concept-organizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cafe3310/public-agent-skills project-design-concept-organizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cafe3310/public-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-design-concept-organizer .claude/skills/project-design-concept-organizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-design-concept-organizer
GitHub stars
255
Token cost
~470 tokens
SKILL.md length
60 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

补充 doc-todo-log-loop,在开发过程中归纳项目的设计理念和架构模式,将开发决策和隐性知识转化为系统的设计文档

  • Works in 4 steps: 简介 (Introduction) → 适用场景 (When to Use) → 操作步骤 → …
  • SKILL.md covers 1. 简介 (Introduction), 2. 适用场景 (When to Use), 3. 操作步骤 and 4. 整理模板 (Template)
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Design Concept Organizer is an agent skill from cafe3310/public-agent-skills. 补充 doc-todo-log-loop,在开发过程中归纳项目的设计理念和架构模式,将开发决策和隐性知识转化为系统的设计文档

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: personal agent skills for better QoL. The licence is Apache-2.0.

Example prompts

  • “/project-design-concept-organizer”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 简介 (Introduction)
  2. 适用场景 (When to Use)
  3. 操作步骤
  4. 整理模板 (Template)

What it can do on your machine

Read from SKILL.md and the folder at commit 6c45501. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Design Concept Organizer loads about 470 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 60 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~470

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cafe3310/public-agent-skills at commit 6c45501, republished under its Apache-2.0 licence (© cafe3310). 60 words, ~470 tokens.

Download SKILL.mdSave it as .claude/skills/project-design-concept-organizer/SKILL.md (or your agent's skills folder).
name
project-design-concept-organizer
description
补充 doc-todo-log-loop,在开发过程中归纳项目的设计理念和架构模式,将开发决策和隐性知识转化为系统的设计文档
license
Apache-2.0
author
github/cafe3310
depends_on_skill
github/cafe3310/public-agent-skills -> doc-todo-log-loop

项目设计与概念整理 (Project Design & Concept Organizer)

1. 简介 (Introduction)

这是一个用于梳理和沉淀项目知识的技能。

在项目开发过程中,我们会自然形成许多设计模式、约定俗成的协议或特定的架构选择。此技能的目标是回顾:从已有的代码和讨论中提炼出这些设计要素,并将其整理为清晰的文档。它帮助我们保持项目概念的一致性,并方便新成员(或未来的自己)理解系统的全貌。

2. 适用场景 (When to Use)

请在以下情况使用本技能:

  1. 阶段性梳理: 完成了一个较大的功能模块,需要总结其设计思路时。
  2. 模式固化: 发现代码中反复出现某种特定的交互方式(如特定的前后端通信协议),需要将其正式定义时。
  3. 补充开发日志: 在记录开发日志(doc-todo-log-loop)后,发现本次更新包含了重要的架构决策,值得单独提取出来时。
  4. 理清思路: 当项目变得复杂,需要重新审视整体结构或目录规划时。

3. 操作步骤

第一步:回顾与识别 (Review & Identify)

回顾近期的代码变更、文件结构调整或关键的对话记录。 思考以下问题:

  • 我们最近解决了什么核心问题?是用什么思路解决的?
  • 代码中是否涌现出了新的“标准做法”或“协议”?
  • 目录结构是否有明确的层级划分意图?
第二步:提炼概念 (Extract Concepts)

将具体的实现细节抽象为通用的设计概念。注意,宁缺毋滥,切勿过分抽象或过度提炼。

  • 示例: 从一系列“修改了的文件”,提炼出“引入了配置驱动的插件机制”。
  • 示例: 从一系列“前端加了某个判断”,提炼出“定义了基于特定标记的流式渲染协议”。
第三步:文档化 (Document)

使用下方的模板,创建或更新项目的设计文档(通常存放在 docs/ 或根目录下,如 ARCHITECTURE.md 或 DESIGN_CONCEPTS.md)。

  • 保持语言平实、准确。
  • 记录“为什么这么做”以及“如何运作”。

4. 整理模板 (Template)

在整理设计文档时,请参考以下结构。你可以根据实际情况灵活调整。

markdown
# [项目/模块名称] 设计理念与架构规范

## 1. 核心理念 (Core Philosophy)
> 简述项目的核心设计原则。不仅仅是“做什么”,更重要的是“为什么这么做”。
*   **原则 1**: [例如:文档驱动开发] - [简短解释]
*   **原则 2**: [例如:UI 与逻辑分离] - [简短解释]

## 2. 关键概念 (Key Concepts)
> 定义项目中特定的术语、模型或隐喻。
*   **[概念名]**: [解释。例如:“Inbox 范式” - 所有输入先进入 Inbox 目录等待分拣。]
*   **[概念名]**: [解释。例如:“Agent 节点” - 图谱中的独立执行单元。]

## 3. 交互协议 (Interaction Protocols)
> 记录前后端交互、组件间通信的特定规则。
*   **协议名称**: [例如:标记流式协议]
    *   **机制**: [描述协议如何工作]
    *   **目的**: [解决了什么问题]

## 4. 架构与目录意图 (Architecture & Directory Intent)
> 解释核心目录或模块的设计意图。
*   `app/core`: [存放核心业务逻辑,不依赖具体 UI]
*   `components/ui`: [纯展示组件,无业务状态]

© cafe3310, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/project-design-concept-organizer of cafe3310/public-agent-skills.

Open the folder on GitHubat commit 6c45501

Compare with similar skills

Project Design Concept Organizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Design Concept Organizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Design Concept Organizer this skillcafe3310/public-agent-skills255—~470Automated safety check: PassApache-2.0
Docnexu-io/open-design100k—~266Automated safety check: PassApache-2.0
Docsremotion-dev/remotion63k—~248Automated safety check: PassCustom licence
Update Docsvercel/next.js143k—~1.9kAutomated safety check: PassMIT
DocsPrefectHQ/fastmcp28k—~1kAutomated safety check: PassApache-2.0
Docs Diagramsvercel/next.js143k—~2.9kAutomated safety check: PassMIT

Similar skills

  • Doc

    nexu-io/open-design

    Read, create, and edit .docx documents with formatting and layout fidelity via OpenAI's document skill.

    100k GitHub stars~266 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Docs

    remotion-dev/remotion

    Official

    Start the Remotion docs site and open it in the Codex browser.

    63k GitHub stars~248 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Update Docs

    vercel/next.js

    Official

    This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature"…

    143k GitHub stars~1.9k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Docs

    PrefectHQ/fastmcp

    Write or revise a page under docs/ for gofastmcp.com. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Docs Diagrams

    vercel/next.js

    Official

    Draw diagrams for the Next.js docs in the style of the ones already published there: the light/dark PNGs an mdx references with <Image srcLight="/docs/light/<name.png" srcDark="/docs/dark/<name.png".

    143k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Docs Artifact

    asgeirtj/system_prompts_leaks

    A skill your agent uses when creating, editing, or reviewing a document for the user (Word, Google Docs, or a document delivered as PDF), or when the task calls for a standalone written deliverable…

    69k GitHub stars~1.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from cafe3310/public-agent-skills

All 29 skills in this repo
  • Impeccable

    cafe3310/public-agent-skills

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    255 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Text Watermark Fountain

    cafe3310/public-agent-skills

    A specialized skill for embedding and extracting resilient watermarks in text by manipulating sentence lengths and using Fountain Codes.

    255 GitHub stars~921 tokensUpdated 3 mo ago
    Auto-check passed
  • Obsidian Todo Collector

    cafe3310/public-agent-skills

    从 Obsidian 知识库中扫描指定时间范围内未完成事件,生成/更新未完成事件整理文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~575 tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Research

    cafe3310/public-agent-skills

    一个全面、自主的深度研究框架。当用户请求对复杂主题、市场调研、技术格局进行深入的多维度调查,或需要大量网页浏览、数据合成和结构化报告的任何任务时,使用此技能。它协调子代理(subagents)并使用基于文件系统的状态管理来防止上下文膨胀。

    255 GitHub stars~996 tokensUpdated 3 mo ago
    Auto-check passed
  • Long Audio To Obsidian

    cafe3310/public-agent-skills

    将语音转写项目输出的复杂文件结构整理合并为适合 Obsidian 归档的 Markdown 文档. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~772 tokensUpdated 3 mo ago
    Auto-check passed
  • Markdown New

    cafe3310/public-agent-skills

    通过 markdown.new API 将网页、整站或搜索结果转换为干净的 Markdown. An agent skill from cafe3310/public-agent-skills.

    255 GitHub stars~344 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Project Design Concept Organizer

What does Project Design Concept Organizer do?

补充 doc-todo-log-loop,在开发过程中归纳项目的设计理念和架构模式,将开发决策和隐性知识转化为系统的设计文档. Project Design Concept Organizer is an agent skill from cafe3310/public-agent-skills.

How do I install Project Design Concept Organizer in Claude Code?

Run `npx skills add cafe3310/public-agent-skills --skill project-design-concept-organizer -a claude-code`. Or copy the skill folder (skills/project-design-concept-organizer in cafe3310/public-agent-skills) into .claude/skills/project-design-concept-organizer in your project. Claude Code loads it when a task matches its description.

How do I install Project Design Concept Organizer in Codex?

Run `npx skills add cafe3310/public-agent-skills --skill project-design-concept-organizer -a codex`. Or copy the skill folder (skills/project-design-concept-organizer in cafe3310/public-agent-skills) into .agents/skills/project-design-concept-organizer in your project. Codex loads it when a task matches its description.

Can I use Project Design Concept Organizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cafe3310/public-agent-skills --skill project-design-concept-organizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-design-concept-organizer, .gemini/skills/project-design-concept-organizer, .github/skills/project-design-concept-organizer and .opencode/skills/project-design-concept-organizer in your project.

What does Project Design Concept Organizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Design Concept Organizer is instructions for the agent only.

Does Project Design Concept Organizer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Design Concept Organizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Design Concept Organizer use?

Project Design Concept Organizer is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Design Concept Organizer use?

About 470 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Design Concept Organizer?

Skills that share tags, products or a category with Project Design Concept Organizer: Doc (nexu-io/open-design, 100k stars), Docs (remotion-dev/remotion, 63k stars), Update Docs (vercel/next.js, 143k stars) and Docs (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Design Concept Organizer?

cafe3310 (a GitHub user) maintains it in cafe3310/public-agent-skills, which has 255 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on June 26, 2026.

Source: cafe3310/public-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.