Guide · Agent skill
How to use the Company Architect agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
Company Architect is an agent skill that makes an AI assistant act as a company-building advisor. It interviews you one phase at a time and writes your answers as a folder tree of linked markdown files that people and AI agents can both read. This guide explains what the skill does, how to install it, how to trigger it, and what it needs, so you can run your first phase.
Company Architectalirezarezvani/claude-skills · MIT Download the skill Quick start
- 1Download and unzip. Download the skill ZIP from this page and unzip it. Keep the folder that contains SKILL.md.
- 2Place or upload the skill. Copy the folder to ~/.claude/skills/ for all projects or to .claude/skills/ in one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
- 3Make a natural request. Ask for help building or documenting your company as a folder of markdown files or an OKF knowledge bundle.
- 4Name the bundle and scaffold. Give the agent a bundle name. It creates the skeleton with scaffold_bundle.py or by hand.
- 5Answer Phase 0 questions. Answer the few numbered questions for each phase. The agent waits for your reply before it writes any files.
- 6Confirm and write each phase. Review the files and types the agent proposes, reply ok, and let it write them. It then runs the linter and index generator.
- 7Check the dashboard. Open the root index.md to see phase progress and the suggested next step, and review log.md for recorded decisions.
What the Company Architect skill makes the agent do
The skill turns the agent into a senior chief of staff that covers strategy, finance, marketing, operations and systems. Its goal is to document a company as an OKF (Open Knowledge Format) bundle: a directory of .md files, where each file is one concept, has a type label in its frontmatter, and links to other files in its body.
The agent does not produce the whole company at once. It runs a 12-phase interview covering foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal and governance. Each phase asks a few numbered questions, and the agent writes the files only after you confirm.
- Each file is one concept, identified by its path without the .md extension.
- Every concept has a required type field in its YAML frontmatter.
- Relations are markdown links in the body, not lists in the frontmatter.
- index.md and log.md are reserved: a folder listing and a decision history, with no type field.
Install the skill from the ZIP or the Claude apps
Download the ZIP from the skill page on this directory and unzip it. To make the skill available to Claude Code for all your projects, place the skill folder inside ~/.claude/skills/. To limit it to one project, place it inside that project's .claude/skills/ folder.
If you use the Claude apps instead, open Settings, go to Capabilities, then Skills, and upload the skill there.
- Personal (all projects): ~/.claude/skills/
- Single project: .claude/skills/ inside the project folder
- Claude apps: Settings → Capabilities → Skills → upload
Trigger the skill with a natural request
The skill activates when you ask for help creating, structuring or documenting a whole company in folders and .md files. The source lists trigger phrases such as build my company from scratch, company as code, company knowledge base for AI to read, company wiki for agents, OKF and knowledge bundle. The skill works in English.
Once it starts, the agent greets you, asks for a bundle name (usually your company name), creates the folder skeleton and begins Phase 0. It then waits for your answers before continuing.
- Build my company from scratch as a set of markdown files.
- I want a company wiki that an AI agent can read and query.
- Help me document my company as an OKF knowledge bundle.
- Set up a company as code with folders and linked .md files.
Run the helper scripts to scaffold, lint and index the bundle
The skill ships three Python scripts that use only the standard library and make the work repeatable. scaffold_bundle.py creates the OKF folder tree with index.md and log.md. okf_linter.py checks that concepts have a type, that reserved files have no type, and that links resolve. index_generator.py rebuilds the index tables and the progress dashboard.
The recommended flow is scaffold, then interview per phase and write concepts, then run the linter, then run the index generator.
python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech
python scripts/okf_linter.py ./my-company
python scripts/index_generator.py ./my-companyExample: what a finished concept looks like
The skill includes a small example bundle for a fictional café. Its foundation concept, identidade.md, starts with a frontmatter block that sets type to Foundation, a title, a description, tags, a timestamp and a status. The body then holds the purpose, mission and values, and links to the problem-solution concept in the same folder.
The example's root index.md acts as a dashboard with company data, a table of phases marked done, in progress or not started, and a suggested next step. Its log.md records each decision with a timestamp.
- Frontmatter: type, title, description, tags, timestamp, status, version.
- Body: plain markdown sections with links such as [problema-solucao](problema-solucao.md).
- Assumptions are marked [ASSUMPTION] so you can confirm them later.
Safety notes: scripts, disk access and network
The skill runs Python scripts, so the source notes that it does run scripts. The source states that it does not use the network, and the scripts do not call external APIs or language models. Python 3 is required, with no external packages.
The agent needs disk access to write the generated files. Without it, the agent outputs each file in a code block with its path, and you must save them yourself. The legal and finance phases are templates for discussion with professionals, not confidential advice.
- Requires Python 3 (standard library only).
- Runs scripts: yes. Uses network: no.
- Without disk access, files are delivered as code blocks.
What people use it for
- A founder documents strategy, pricing and operations decisions as dated, linked markdown files.
- A small team builds a company knowledge base that an AI agent can search and read.
- A developer keeps business documentation in a git repository and reviews changes like code.
- A founder works through the 12 phases before writing a more detailed plan in another format.
Frequently asked questions
Is the Company Architect agent skill free?
The skill is published under the MIT licence, as stated on its page. The source does not mention any price, so check the directory listing for current terms before you use it.
What does the Company Architect skill require to run?
It requires Python 3, using only the standard library with no external packages. The agent also needs disk access to write files; without it, the agent outputs each file in a code block instead.
How do I install the Company Architect skill?
Download the ZIP from the skill page and unzip it. Place the skill folder in ~/.claude/skills/ for all projects or in a project's .claude/skills/ folder, or upload it in the Claude apps under Settings → Capabilities → Skills.
Does the Company Architect skill use the internet?
No. The source states that the skill does not use the network. Its scripts run locally and do not call external APIs or language models.
What is an OKF bundle?
OKF stands for Open Knowledge Format. It is a directory of markdown files where each file is one concept with a type in its frontmatter, and links between files form a graph that humans and AI agents can read.
Can I use this instead of writing a quick business plan?
The skill is not meant for a one-off business plan with no folder structure. It runs a phase-by-phase interview first, so it suits people who want their plans documented as linked files. For a quick plan, writing one document directly will be faster.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use Company Architect if you want your company's plans and decisions kept as version-controlled markdown that an AI agent can also read, and you are willing to answer questions phase by phase. Pick something else if you need a quick one-off plan, or confidential legal or financial advice, since the legal and finance phases are only templates for discussion with professionals.
Download the skill