Project Architect skill
Project Architect interviews you on a project idea and outputs a spec, plan, tasks, branding and one agent prompt.
- 261 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill creates document files in the project and runs no code.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/project-architectDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill creates document files in the project and runs no code.
This is third-party code. Review the repository files before installing.
What it does
The skill interviews you about a project idea and writes five documents in turn: `SPECIFICATION.md` with features and data model, `IMPLEMENTATION.md` with stack and directory layout, `TASKS.md`, `BRANDING.md` and `PROMPT.md`. The last one combines everything into a self-contained prompt from which an agent builds the project from scratch. Along the way it compares technology options with trade-offs, matches design patterns with code sketches and scales the task count to project size: about 15 for a weekend hack and over 100 for an enterprise system. Each task names files and acceptance criteria, and the skill waits for approval after every document.
Who it is for. Developers and founders who have a project idea but no plan and want to hand the coding to an agent in a single run.
Good fit when
- An idea must become a specification and plan before coding starts.
- One long prompt with a full project description goes to the agent.
- A task list is wanted where each item fits one agent session.
- A user-facing product needs a name, colors and typography.
Not a fit when
- You need a small edit in existing code.
- The project is already described and the documents would be redundant.
- A strict process from a given methodology, such as Spec Kit, is required.
Example request
Use project-architect: I have a booking service idea, interview me and prepare the specification, plan and tasks.Limitations
The skill generates documents from the dialogue, while checking the chosen stack, library versions and effort estimates remains on you. Plan quality depends on your answers and on the agent's model. The README carries a large promotional block for the third-party agent WrongStack, which is not part of the skill. Claude Code plugin mode requires adding the folder path to `.claude/settings.json` by hand. The last commit is from October 2026.
How to disable. Delete the `project-architect` folder from the agent's skills directory, for example `~/.claude/skills/`.
FAQ
Which documents does the skill create?
Five files: `SPECIFICATION.md`, `IMPLEMENTATION.md`, `TASKS.md`, `BRANDING.md` and `PROMPT.md`. `BRANDING.md` is only for user-facing projects.
Which agents does it work with?
The README names over 40 agents compatible with the agentskills.io standard, including Claude Code, Cursor, Gemini CLI, Codex and GitHub Copilot.
How do I install it for one agent?
Add the `--agent` flag, for example `npx skills add ersinkoc/project-architect --agent claude-code`.
Can I install globally?
Yes, the command with the `--global` flag installs the skill for all projects.
How many tasks will I get?
It scales with the project: about 15 for a weekend hack and over 100 for an enterprise system.
Discussion
No questions or reviews yet.
Related
SkillsA skill for choosing a stack, architecture and project plan: checks advice against your constraints, comparable projects, prices and failure conditions
Builder Skills
Skills for agents
A set of small skills from Builder.io for agent work habits: visual plans and diff recaps, docs-first checks, cross-agent review and clean status updates
Nine JS Mastery skills take a change through phases: from idea and spec to verification, tests, release texts and a docs sync
Nine short skills: tests, review, ADR plans, slides, a wiki, image generation, worktrees and plan implementation.
Eight skills for engineering habits: think a plan through, find a bug's root cause, check a diff, read a source
Orchestrator skill: from an idea the agent writes requirements and a spec, splits work into tasks, builds the project, checks it
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Project Architect (this card) | no | 261 | |
| Spec Kit | no | 149,633 | Spec Kit steers spec-driven development command by command; Project Architect produces a document set and a single prompt in one dialogue |
| create-prd | no | 376 | create-prd writes product requirements only; Project Architect adds stack, patterns, tasks and branding |
README in short
A dialogue turns an idea into five linked documents and one agent prompt. The skill waits for approval after every document.