← Back to Skills Marketplace
Project Brief Writer
by
vx：17605205782
· GitHub ↗
· v1.0.0
· MIT-0
153
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install project-brief-writer
Description
把零散需求、聊天和会议内容整理成项目任务书、边界、验收标准和风险清单。；use for project-brief, requirements, scope workflows；do not use for 生成法律合同, 替代正式需求审批.
Usage Guidance
This skill appears coherent and local-only: it bundles a readable Python script and templates and asks only for python3. Before installing/using it: (1) inspect scripts/run.py yourself (it is included and human-readable); (2) run the provided smoke test with the example input to verify behavior; (3) avoid passing root/system directories or sensitive paths as the --input to the script because its directory/pattern-audit code can read many file types and could surface sensitive content in the generated report; (4) because it does not perform network calls or require credentials, risk is limited to local data exposure — consider running it in a restricted workspace or with sanitized inputs if you have sensitive files. If you need higher assurance, ask the publisher for provenance or run the script in an isolated container.
Capability Analysis
Type: OpenClaw Skill
Name: project-brief-writer
Version: 1.0.0
The skill bundle is designed to organize project requirements into structured briefs and contains no malicious logic. While the Python script (`scripts/run.py`) includes functionality for 'pattern_audit' and 'skill_audit'—which scan for hardcoded secrets and dangerous shell commands—these features are diagnostic and defensive in nature. The instructions in `SKILL.md` are well-defined, and there is no evidence of data exfiltration, unauthorized execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (project brief writer) align with declared requirements (python3) and included resources (template, spec, examples). However, the included scripts contain additional audit utilities (directory_report, pattern_report, skill_audit, csv_report) that go beyond a minimal brief-generator; these functions allow scanning directories and multiple file types and performing pattern matching for secrets. This added functionality is plausible as a convenience for local audits, but is broader than the simple 'brief writer' description.
Instruction Scope
SKILL.md instructs the agent to run the local script using the skill's baseDir and otherwise to generate output from local templates. It does not instruct the agent to read system-wide files or network resources. The run.py script, however, can accept arbitrary filesystem paths and will recursively list and read many text file types for directory or pattern audits if invoked in those modes — so the runtime instructions are safe if used as intended (pointing to skill files or supplied inputs) but could read sensitive local files if the user/agent supplies broad paths.
Install Mechanism
No install spec; instruction-only with bundled Python script. Nothing is downloaded or extracted from external URLs, and the README/SELF_CHECK state only Python standard-library usage.
Credentials
The skill requires only python3 and declares no environment variables, credentials, or config paths. The code does not attempt to read environment variables or request secrets.
Persistence & Privilege
always is false and the skill does not request persistent or elevated privileges. It does not attempt to modify other skills or global agent settings; default autonomous invocation remains allowed (platform default) but is not combined with other concerning privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install project-brief-writer - After installation, invoke the skill by name or use
/project-brief-writer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of project-brief-writer:
- Organizes scattered requirements, conversations, and meeting notes into a structured project brief.
- Outputs include project objectives, scope (in and out), key requirements, acceptance criteria, dependencies, risks, and milestones.
- Explicitly lists items needing clarification rather than assuming or inventing missing information.
- Not suitable for generating legal contracts or replacing formal requirement approvals.
- Highlights boundaries and risks, with draft output for review before execution.
- Utilizes local resources for templates and specifications where available.
Metadata
Frequently Asked Questions
What is Project Brief Writer?
把零散需求、聊天和会议内容整理成项目任务书、边界、验收标准和风险清单。；use for project-brief, requirements, scope workflows；do not use for 生成法律合同, 替代正式需求审批. It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.
How do I install Project Brief Writer?
Run "/install project-brief-writer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Project Brief Writer free?
Yes, Project Brief Writer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Project Brief Writer support?
Project Brief Writer is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).
Who created Project Brief Writer?
It is built and maintained by vx：17605205782 (@52yuanchangxing); the current version is v1.0.0.
More Skills