← Back to Skills Marketplace
agent-project-structure
by
Song Xianfeng
· GitHub ↗
· v1.0.0
· MIT-0
45
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agent-project-structure
Description
Agent project directory structure规范。指导agent生成规范的项目文件结构，包括：项目文件单独存放在项目目录下，日志文件统一放在log目录，临时文件（截图、缓存等）与正式文件分离。使用时检查现有结构是否符合规范，或根据规范创建/调整目录结构。
README (SKILL.md)
Agent Project Structure 规范
快速开始
检查现有结构
python scripts/check_structure.py \x3C项目路径>
创建新项目结构
python scripts/create_structure.py \x3C项目路径>
标准目录结构
agent-project/
├── projects/ # 项目文件目录
├── log/ # 日志文件目录
├── temp/ # 临时文件目录（截图、缓存等）
│ ├── screenshots/ # 截图文件
│ └── cache/ # 缓存文件
├── config/ # 配置文件目录
├── data/ # 数据文件目录
│ ├── input/ # 输入数据
│ └── output/ # 输出数据
├── scripts/ # 脚本文件目录
└── docs/ # 文档目录
文件分类原则
| 类型 | 目录 | 说明 |
|---|---|---|
| 项目文件 | projects/ |
项目代码、资源 |
| 日志文件 | log/ |
应用日志 |
| 临时文件 | temp/ |
截图、缓存 |
| 配置文件 | config/ |
环境配置 |
| 数据文件 | data/ |
输入/输出数据 |
使用场景
- 检查现有结构 - 检查现有项目结构是否符合规范
- 创建新项目 - 生成标准目录结构
- 重构项目结构 - 指导现有项目重构
相关资源
- QUICK_START.md - 快速开始指南
- references/PROJECT_STRUCTURE.md - 详细规范说明
- references/GITIGNORE.md - .gitignore 模板
Usage Guidance
This skill appears safe for organizing local project directories. Before installing or using it, note that the create script writes folders and placeholder files under the path you provide; avoid running it against important existing directories unless you have reviewed what it will create and have a backup if needed.
Capability Analysis
Type: OpenClaw Skill
Name: agent-project-structure
Version: 1.0.0
The skill bundle provides a standardized project directory structure for AI agents, including scripts to validate and create the layout. The Python scripts (check_structure.py and create_structure.py) perform legitimate file system operations consistent with the stated purpose, and no evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The stated purpose is to check or create a standardized agent project directory layout, and the included files consistently document and implement that behavior.
Instruction Scope
The usage examples ask the user to run local Python helper scripts against a project path; this is purpose-aligned, but users should choose the target path carefully.
Install Mechanism
There is no install spec and no external dependency, but the skill does rely on running the included Python scripts despite metadata declaring no required binaries.
Credentials
The create script performs local filesystem writes under the supplied path, which is expected for a directory-structure helper but should be run only on intended project directories.
Persistence & Privilege
The skill creates persistent project folders and placeholder files only when invoked; there is no evidence of background execution, privilege escalation, credential use, or ongoing persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-project-structure - After installation, invoke the skill by name or use
/agent-project-structure - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release introducing the agent-project-structure skill.
- Provides a standard directory structure for agent projects, separating project files, logs, temp data, configs, and documentation.
- Includes scripts to check existing structures or create new, compliant directory layouts.
- Offers clear documentation and usage examples for both new and existing projects.
Metadata
Frequently Asked Questions
What is agent-project-structure?
Agent project directory structure规范。指导agent生成规范的项目文件结构，包括：项目文件单独存放在项目目录下，日志文件统一放在log目录，临时文件（截图、缓存等）与正式文件分离。使用时检查现有结构是否符合规范，或根据规范创建/调整目录结构。 It is an AI Agent Skill for Claude Code / OpenClaw, with 45 downloads so far.
How do I install agent-project-structure?
Run "/install agent-project-structure" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is agent-project-structure free?
Yes, agent-project-structure is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does agent-project-structure support?
agent-project-structure is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created agent-project-structure?
It is built and maintained by Song Xianfeng (@songxf1024); the current version is v1.0.0.
More Skills