init-agent-project

init-agent-project is a skill for Codex from DongLiStudio/personal-agent-foundation. It costs 90 tokens per session (2,761 once invoked), scanned A, original, Apache-2.0.

A procedure for initializing an Agent-managed project workspace and registering it in shared project records. It creates the standard documentation, task, archive, and configuration structure.

In plain words
What is it for?
Use it to create a project, write its README, status, and agent instructions, create standard folders, initialize Git, and register the project globally.
Why use it?
It prevents new projects from starting with missing context, unclear ownership, or inconsistent files and records.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: installed under .agents/ (shared by several agents); mentions AGENTS.md.

Good fit Use it to create a project, write its README, status, and agent instructions, create standard folders, initialize Git, and register the project globally.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/donglistudio/personal-agent-foundation/init-agent-project
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 DongLiStudio/personal-agent-foundation --skill init-agent-project
Clone the repo
git clone --depth 1 https://github.com/DongLiStudio/personal-agent-foundation

Made for: 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 init-agent-project

README.md
[![agentmods](https://agentmods.dev/badge/skills/donglistudio/personal-agent-foundation/init-agent-project.svg)](https://agentmods.dev/skills/donglistudio/personal-agent-foundation/init-agent-project)
Your own site
<a href="https://agentmods.dev/skills/donglistudio/personal-agent-foundation/init-agent-project"><img src="https://agentmods.dev/badge/skills/donglistudio/personal-agent-foundation/init-agent-project.svg" alt="Measured on agentmods" height="20"></a>
Per session 90 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,761 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.
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.00090 $0.02761
Opus 5 $0.00045 $0.01380
Sonnet 5 $0.00018 $0.00552
Haiku 4.5 $0.00009 $0.00276

Measured 8d ago against content hash 71cd08084169, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

init-agent-project 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 8d 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.

template/GLOBAL/.agents/skills/init-agent-project/SKILL.md · 171 lines

How it starts

The opening of the file, as written. The whole thing — 171 lines — stays where its author put it; the contents beside it link to each section on GitHub.

初始化 Agent 项目

使用这个 skill 初始化真实的 Agent 项目工作区,并把项目登记进 GLOBAL

核心规则

项目进入初始化阶段时,就应该登记进 GLOBAL/PROJECTS.md,不需要等项目成熟。

标准结构要提前创建,即使某些目录暂时为空。目录本身承载语义信息,可以让未来的 Agent 任务稳定地知道资料应该放在哪里。

当项目名、项目根目录、项目目标都明确时,默认完成完整初始化,包括 git init。不要自动 git add、commit 或设置 remote。

项目内部 Skill 或 agent 相关内容遵循 Agent 自动生成和管理的 .agents/ 机制。GLOBAL/.agents/skills/ 是个人全局 Skill 源稿目录,语义不同。

信息完整性

初始化前确认三项信息:

  • 项目名。
  • 项目根目录。
  • 一句话项目目标或方向。

如果项目目标、当前阶段或背景不明确,不要马上问用户。先按顺序只读查找:

  1. 当前项目目录已有文件,例如 README.mdSTATUS.mdAGENTS.mddocs/tasks/
  2. 当前 Agent 可用的长期记忆中,与该项目有关的最新阶段、用户决策、交接信息和偏好。
  3. {{AGENT_ROOT}}\GLOBAL\PROJECTS.md 中的项目登记。
  4. GLOBAL 中相关规则和索引。
  5. 如果项目明显依赖长期知识,再只读搜索 Obsidian 或关联知识库。

信息来源的优先级:当前用户明确说明 > 当前项目文档 > 当前 Agent 可用的长期记忆 > GLOBAL 索引/规则 > Obsidian 或关联知识库。

如果长期记忆与 Obsidian 冲突,不要静默采用旧资料。阶段、当前状态和近期工作优先采用用户最新说明、当前项目文档和当前 Agent 可用的长期记忆;Obsidian 更适合作为历史规划、素材和背景来源。冲突会影响项目定位或下一步时,报告冲突并询问用户。

如果资料中的工程状态、代码状态、发布状态可能已经变化,先到对应仓库或文件实时确认,再写入 README、STATUS 或 AGENTS。不能实时确认时,明确标注“根据现有资料推断,可能需要刷新”。

能从资料中合理判断时,使用该判断初始化,并在结果里说明依据。仍无法确认时,只问必要问题,优先问:“这个项目的一句话目标是什么?”

不要在项目目标不清楚时写死项目定位;可以在 README.mdSTATUS.md 中暂写“待明确”。

标准结构

创建或保留以下结构:

项目名/
  README.md
  STATUS.md
  AGENTS.md
  .gitignore
  docs/
    .gitkeep
  tasks/
    .gitkeep
  archive/
    .gitkeep

目录和文件语义:

  • README.md:项目身份、目标、目录入口和使用方式。
  • STATUS.md:项目当前阶段、近期目标、下一步、阻塞和必要的阶段记录;避免长期堆积流水账。
  • AGENTS.md:给未来 Agent 的项目内工作规则;必须说明 GLOBAL 是上层治理入口,且上层规则默认适用于项目工作。
  • .gitignore:基础忽略规则,避免缓存、日志和临时文件入库。
  • docs/:长期有效的项目文档和规划资料。
  • tasks/:任务计划、交接、检查清单和当前工作记录。
  • archive/:已完成、过时或历史性的项目资料。
  • .agents/:如 Agent 自动生成,用于项目内 Skill/agent 运行或安装内容。
  • .gitkeep:只用于让 Git 跟踪空语义目录;目录中有实际内容后应移除。

AGENTS.md 最小规则

AGENTS.md 必须包含 GLOBAL 规则,简明说明:

  • GLOBAL 路径:{{AGENT_ROOT}}\GLOBAL
  • GLOBAL 是上层治理入口,不是项目工作区;其中的上层规则默认适用于项目工作。
  • 项目内 README.mdSTATUS.mdAGENTS.md 是持续工作入口;相关任务文件按当前任务需要读取。
  • GLOBAL\README.mdGLOBAL_CONTEXT.md 是默认全局入口,应持续关注。
  • 涉及跨项目规则、项目索引、全局 Skill、账号/工具约定、长期上下文或 Obsidian 时,按范围回看 GLOBAL 中的对应文件以获得细节。
  • 项目原则上独立维护 Git 和版本历史;阶段性成果按项目规则创建聚焦提交,提交前检查 diff、相关验证和敏感信息,不跨项目暂存、不混入无关改动,也不把 commit 等同于 push。
  • 项目需要远程备份时,专属 GitHub 账号或项目路由优先;没有专属规则时使用 GLOBAL 记录的全局默认账号。首次创建远程仓库、确定仓库名与可见性、配置 remote 和首次 push 前必须获得用户明确授权,不自动上传。
  • 默认创建 ## 项目组织 模块并设立“项目总经理”职责,负责整体判断、任务拆分、长期岗位任命、结果验收和跨项目汇报。
  • 用户明确任命其他长期岗位后,在“项目组织”模块记录岗位名称、稳定职责及协作边界;不要为了结构完整虚构岗位。
  • 写入按需岗位规则:首次持续创建或维护飞书任务时,feishu-task 若未发现等价岗位,补充“项目任务协调员”;{{GENERAL_ASSISTANT_PROJECT}}首次承担跨项目个人排程时,personal-schedule-planner 若未发现等价岗位,补充“个人时间管理员”。已有等价岗位时复用,不重复设置;新项目初始化时只写规则,不预先虚构尚未启用的岗位。
  • “项目组织”模块只记录项目总经理、用户已明确任命或按需规则实际补充的其他长期岗位及通用协作规则;不记录任务窗口 ID、临时忙闲、单次派工或组织变更流水账。
  • 明确长期任务窗口与当前任务临时子智能体的区别;临时子智能体不自动成为项目长期岗位,同一人或任务窗口可以兼任多个职责。
  • 明确按需岗位补充不是只改 AGENTS.md:当规则要求新增或复用长期岗位时,完成条件必须同时包含项目 AGENTS.md 已登记、对应长期会话/任务窗口已创建或复用、岗位启动指令和当前上下文已交给该窗口、该窗口已回报接单或阻塞。宿主暂不支持创建/定位长期窗口时,必须把“执行窗口待创建/待用户接管”作为待办或阻塞边界,不得宣称岗位已完整落地。
  • 明确每个长期岗位默认有权按任务需要自行创建和使用会话内临时子智能体,无需逐次申请;临时子智能体只能承接该岗位本来可以执行的工作,不扩大任务范围或操作权限,长期岗位仍负责委派判断、结果验收和最终回报。
  • 明确长期岗位完成派发任务后必须主动向项目总经理回报结果、验证、提交或外部操作、遗留问题和建议下一步,不得只在自己的任务窗口中结束。

Read the full file on GitHub · 171 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 8d ago First seen · 171 lines · 90 tokens per session scan A 71cd08084169

Subscribe to this mod's changes

init-agent-project is a skill published in the GitHub repository DongLiStudio/personal-agent-foundation (11 stars, last pushed 21d ago), licensed Apache-2.0. It adds 90 tokens to every session and 2,761 once invoked, about $0.0005 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

harness

Use when governing a workspace's control plane, code or not — the 01-TOOLS/ tooling layer, the 02-DOCS/ chaos→knowledge wiki, the root Knowledge map. Audits it, migrates legacy XX- folders, scaffolds provider tooling, sweeps the inbox, writes root CLAUDE.md/AGENTS.md. NOT the bootstrap front door (that is init, which…

ericrisco/rsc-harness · 94 tokens

swarmauri-add-standards-standalone

Add a first-class standalone Swarmauri package under pkgs/standards. Use when Codex needs package scaffolding, workspace membership, pyproject metadata, Swarmauri or Tigrbl branding, entry points, first-class citizenship registry rows, exports, tests, and validation.

swarmauri/swarmauri-sdk · 69 tokens

recipe-create-meet-space

Create a Google Meet meeting space and share the join link.

googleworkspace/cli · 18 tokens

workthreads

SpecStory Workthreads - a weekly work-thread rollup across a team's repos from SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more). It groups the window's sessions into threads of work per project and labels each new / open / recently closed, so a lead sees what shipped, what is still…

specstoryai/getspecstory · 126 tokens

atmos-config

Atmos root configuration: atmos.yaml discovery, precedence, deep merging, basepath, imports, minimal bootstrap, and routing to narrower Atmos skills.

cloudposse/atmos · 31 tokens

story-readiness

Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and no open design questions. Produces READY / NEEDS WORK / BLOCKED verdict with specific gaps. Use when user says 'is this story ready', 'can I start on this story', 'is…

Donchitos/Claude-Code-Game-Studios · 77 tokens