project-design-concept-organizer

project-design-concept-organizer is a skill for Claude Code, Codex from cafe3310/public-agent-skills. It costs 43 tokens per session (1,044 once invoked), scanned A, original, Apache-2.0.

A documentation workflow for extracting reusable design ideas and architectural decisions from a project’s code, file structure, and discussions. Architecture means the main structure and design choices that determine how a software system is organised.

In plain words
What is it for?
It helps review recent changes, identify repeated conventions or protocols, name the underlying design concepts, and document how and why the project is structured.
Why use it?
Important decisions can remain hidden in implementation details or be forgotten after a feature is finished. Recording the reasons and patterns helps new team members and future maintenance work.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It helps review recent changes, identify repeated conventions or protocols, name the underlying design concepts, and document how and why the project is structured.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cafe3310/public-agent-skills/project-design-concept-organizer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cafe3310/public-agent-skills --skill project-design-concept-organizer
Clone the repo
git clone --depth 1 https://github.com/cafe3310/public-agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for project-design-concept-organizer

README.md
[![agentmods](https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/project-design-concept-organizer/github.svg)](https://agentmods.dev/skills/cafe3310/public-agent-skills/project-design-concept-organizer)
Your own site
<a href="https://agentmods.dev/skills/cafe3310/public-agent-skills/project-design-concept-organizer"><img src="https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/project-design-concept-organizer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for project-design-concept-organizer

Your own site · 80×15
<a href="https://agentmods.dev/skills/cafe3310/public-agent-skills/project-design-concept-organizer"><img src="https://agentmods.dev/badge/skills/cafe3310/public-agent-skills/project-design-concept-organizer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,044 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.01044
Opus 5 $0.00022 $0.00522
Sonnet 5 $0.00009 $0.00209
Haiku 4.5 $0.00004 $0.00104

Measured 12d ago against content hash 60256184a012, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

project-design-concept-organizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/project-design-concept-organizer/SKILL.md · 75 lines

What it actually says

项目设计与概念整理 (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.mdDESIGN_CONCEPTS.md)。

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

4. 整理模板 (Template)

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

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

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

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

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

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

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 75 lines · 43 tokens per session scan A 60256184a012

Subscribe to this mod's changes

project-design-concept-organizer is a skill published in the GitHub repository cafe3310/public-agent-skills (253 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 43 tokens to every session and 1,044 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

experts

Assemble a panel of experts to assess a problem from multiple professional perspectives, surface agreement and disagreement, and deliver a chaired recommendation with clear tradeoffs. Use when the user wants multi-expert judgment, a second opinion, design critique, option comparison, or a recommendation backed by…

flc1125/skills · 62 tokens

create-plan

A guide for creating repository-aware technical plans: written proposals for implementation, refactoring, migration, or design work based on the actual codebase.

flc1125/skills · 114 tokens

github-release-notes-writer

Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and supplied changelog baselines. Use when preparing prerelease or stable release notes, turning GitHub's generated What's Changed list into a curated narrative, documenting upgrades or breaking changes, or…

flc1125/skills · 84 tokens

google-fonts-curator

Recommend high-taste Google Fonts for websites based on brand tone, page type, and visual direction. Use when the user needs font selection, font pairing, or aesthetic judgment within the Google Fonts ecosystem for landing pages, brand sites, editorial pages, portfolios, or digital products.

flc1125/skills · 61 tokens

programmer-motivator

Give calm, technically grounded encouragement to programmers when the user is stuck on a bug, frustrated by debugging, tired, discouraged, blaming themselves after a mistake, asking for motivation or emotional support while coding, wanting someone to stay with them through a hard problem, celebrating a breakthrough…

flc1125/skills · 102 tokens

subagent-orchestrator

Orchestrate subagent workflows for complex tasks that benefit from decomposition, role-based delegation, and parallel execution. Use when Codex should assemble a temporary team of subagents, choose roles from a reusable role library, create a controlled fallback role when no preset role fits, coordinate read-heavy…

flc1125/skills · 87 tokens