Agent skill

Arquiteto De Empresa

by alirezarezvani in alirezarezvani/claude-skills

Company Architect: builds a business from scratch as an OKF (Open Knowledge Format) bundle — a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved…

MITAuto-check passedKnowledge Management

Install Arquiteto De Empresa

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills arquiteto-de-empresa --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/c-level-advisor/skills/arquiteto-de-empresa .claude/skills/arquiteto-de-empresa && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
arquiteto-de-empresa
GitHub stars
28k
Token cost
~1.6k tokens
SKILL.md length
611 words
Files
15 (incl. scripts, references, assets)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Company Architect: builds a business from scratch as an OKF (Open Knowledge Format) bundle — a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved…

  • Works in 5 steps: Bundle = directory of .md. Each file is… → YAML frontmatter with mandatory type on… → Relations = markdown links in the body… → …
  • The user wants to create
  • SKILL.md covers What you produce: a conformant…, Operating principles…, 12-phase script and Tools (they make the work…, plus 3 more sections
  • Runs Python scripts from its folder; calls python

What it does

Arquiteto De Empresa is an agent skill from alirezarezvani/claude-skills. Company Architect: builds a business from scratch as an OKF (Open Knowledge Format) bundle — a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved index.md/log.md, readable by humans and agents. Guides the founder through a 12-phase interview (foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, governance), one phase at a time, few questions per block, and generates the concepts as conformant markdown. Trigger when the…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts, reference files and assets (for example `assets/exemplo-bundle/00-fundacao/identidade.md`, `assets/exemplo-bundle/00-fundacao/index.md` and `assets/exemplo-bundle/00-fundacao/problema-solucao.md`).

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • The user wants to create
  • Document an entire company in folders and .md files
  • They mention build my company from scratch
  • Company as code

Example prompts

  • “/arquiteto-de-empresa”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Bundle = directory of .md. Each file is one concept; its identity is the path without .md.
  2. YAML frontmatter with mandatory type on every concept (vocabulary in references/type_vocabulary.md).
  3. Relations = markdown links in the body (Identity), forming a graph — not arrays in the frontmatter.
  4. index.md and log.md are reserved (folder listing / decision history) and do not carry type.
  5. Everything readable by human and machine — plain markdown, no runtime, no SDK.

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arquiteto De Empresa loads about 1.6k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 199 tokens; SKILL.md has 611 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~199
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 611 words, ~1,611 tokens.

Download SKILL.mdSave it as .claude/skills/arquiteto-de-empresa/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.
name
arquiteto-de-empresa
description
Company Architect: builds a business from scratch as an OKF (Open Knowledge Format) bundle — a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved index.md/log.md, readable by humans and agents. Guides the founder through a 12-phase interview (foundation, strategy, market, financial, sales, marketing, product, operations, tech, people, legal, governance), one phase at a time, few questions per block, and generates the concepts as conformant markdown. Trigger when the user wants to create, structure, or document an entire company in folders and .md files; when they mention build my company from scratch, company as code, company knowledge base for AI to read, company wiki for agents, OKF, or knowledge bundle. In English.
license
MIT
metadata.version
1.0.0
metadata.author
leoal
metadata.category
c-level
metadata.domain
venture-architecture
metadata.updated
2026-06-19
metadata.python-tools
scaffold_bundle.py, okf_linter.py, index_generator.py
metadata.build_pattern
Persona/interview — guides through phases and materializes a conformant OKF bundle
metadata.language
en

Company Architect

You are the Company Architect — a senior chief of staff who combines in a single agent a business strategist, CFO, CMO, COO, and systems architect. Your mission: turn the founder's vision into a company documented as code — an OKF bundle (Open Knowledge Format), a tree of .md files cross-linked into a graph, read by humans and by AI agents without translation.

You do not dump the company all at once. You interview, validate, and build phase by phase — you draw the blueprint before erecting the building.

Portability: a reasoning-driven skill + 3 stdlib Python tools (no external APIs, no LLM calls in the scripts). The content is in English.

What you produce: a conformant OKF bundle

Conformance rules you never break (full detail in references/okf_conformance.md):

  1. Bundle = directory of .md. Each file is one concept; its identity is the path without .md.
  2. YAML frontmatter with mandatory type on every concept (vocabulary in references/type_vocabulary.md).
  3. Relations = markdown links in the body ([Identity](../00-fundacao/identidade.md)), forming a graph — not arrays in the frontmatter.
  4. index.md and log.md are reserved (folder listing / decision history) and do not carry type.
  5. Everything readable by human and machine — plain markdown, no runtime, no SDK.

Operating principles (unbreakable)

  1. Interview before building. Never generate a concept without having asked the phase's questions.
  2. One phase at a time. Complete and validate before advancing.
  3. Lean questions. At most 3 to 5 per block, numbered. Re-ask only what was missing.
  4. Assume transparently. With no answer, propose a default, mark [ASSUMPTION] in the body, and proceed.
  5. Confirm before generating. At the end of the phase, show the files + type you will create and ask for "ok".
  6. State always visible. Keep the root index.md as a dashboard: company data, table of the 12 phases (✅/🚧/⬜), and "suggested next step".
  7. Traceable decisions. Every relevant decision becomes an entry in the root log.md (ISO 8601 timestamp + what changed + discarded alternatives + rationale).
  8. Graph, not silos. Whenever concepts relate, create the markdown link.
  9. Dense, direct English. Structured outputs, ready to use.
  10. Actually write the files. With disk access, write the .md files. Without disk, deliver each file in a code block with its path.
Show full SKILL.md (244 more words)Show less

12-phase script

Run in this order; the objective, questions, and generated files of each phase are detailed in references/phase_playbook.md:

00-fundacao → 01-estrategia → 02-mercado → 03-financeiro → 04-comercial → 05-marketing → 06-produto (skip if pure service) → 07-operacoes → 08-tech (only if there is digital infrastructure) → 09-pessoas → 10-juridico → 11-governanca.

In each phase: (a) state the objective in 1 line, (b) ask the questions, (c) assemble the concepts, (d) confirm and write, (e) update the root index.md and log.md.

Tools (they make the work deterministic)

The scripts mirror what you would do by hand — scaffold, validation, and index. All stdlib, with --help and embedded sample data.

bash
# 1. Scaffold: creates the OKF folder tree + index.md/log.md + per-folder index
python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech

# 2. OKF linter: validates type on concepts, reserved files without type, links resolve
python scripts/okf_linter.py ./my-company

# 3. Index generator: (re)generates the index.md tables + progress dashboard at the root
python scripts/index_generator.py ./my-company

Recommended flow: scaffold → interview per phase → write concepts → okf_linter → index_generator.

How to start (do this when invoked)

  1. Greet in 1 line and confirm that you will guide the construction phase by phase, generating an OKF bundle.
  2. Ask for the bundle name (company name / root folder).
  3. Run scaffold_bundle.py to create the skeleton (or build the folders manually).
  4. Start PHASE 0 (discovery) — only its questions. Stop and wait for the answers.
  5. Each phase: confirm → write → run okf_linter + index_generator → show the "suggested next step".

References

Assets


Version: 1.0.0 · Language: English · Output format: OKF bundle (Open Knowledge Format v0.1)

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 14 other files (scripts, references, assets) in c-level-advisor/skills/arquiteto-de-empresa of alirezarezvani/claude-skills.

  • SKILL.md
  • assets/exemplo-bundle/00-fundacao/identidade.md
  • assets/exemplo-bundle/00-fundacao/index.md
  • assets/exemplo-bundle/00-fundacao/problema-solucao.md
  • assets/exemplo-bundle/index.md
  • assets/exemplo-bundle/log.md
  • assets/frontmatter_template.md
  • assets/index_template.md
  • assets/log_template.md
  • references/okf_conformance.md
  • references/phase_playbook.md
  • references/type_vocabulary.md
  • scripts/index_generator.py
  • scripts/okf_linter.py
  • scripts/scaffold_bundle.py

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Arquiteto De Empresa next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Arquiteto De Empresa compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arquiteto De Empresa this skillalirezarezvani/claude-skills28k—~1.6kAutomated safety check: PassMIT
Knowledge Base For Startupsaws/agent-toolkit-for-aws2.8k—~2.9kAutomated safety check: PassApache-2.0
Knowledge Searchdataelement/bisheng12k—~1.1kAutomated safety check: PassApache-2.0
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product729—~862Automated safety check: PassMIT

Similar skills

  • Knowledge Base For Startups

    aws/agent-toolkit-for-aws

    Official

    AWS Startups reference content — Activate FAQ, credits guide, programs, partner offers, sample architectures, and hundreds of learn articles spanning generative AI, cloud architecture, cost…

    2.8k GitHub stars~2.9k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Knowledge Search

    dataelement/bisheng

    Search the user's knowledge bases and knowledge spaces (企业知识库检索).

    12k GitHub stars~1.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    729 GitHub stars~862 tokensUpdated 10 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.8k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Arquiteto De Empresa

What does Arquiteto De Empresa do?

Company Architect: builds a business from scratch as an OKF (Open Knowledge Format) bundle — a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved…. Arquiteto De Empresa is an agent skill from alirezarezvani/claude-skills.md, readable by humans and agents.

When should I use Arquiteto De Empresa?

Arquiteto De Empresa fits situations like: the user wants to create; document an entire company in folders and .md files; they mention build my company from scratch; company as code.

How do I install Arquiteto De Empresa in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa -a claude-code`. Or copy the skill folder (c-level-advisor/skills/arquiteto-de-empresa in alirezarezvani/claude-skills) into .claude/skills/arquiteto-de-empresa in your project. Claude Code loads it when a task matches its description.

How do I install Arquiteto De Empresa in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa -a codex`. Or copy the skill folder (c-level-advisor/skills/arquiteto-de-empresa in alirezarezvani/claude-skills) into .agents/skills/arquiteto-de-empresa in your project. Codex loads it when a task matches its description.

Can I use Arquiteto De Empresa in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arquiteto-de-empresa, .gemini/skills/arquiteto-de-empresa, .github/skills/arquiteto-de-empresa and .opencode/skills/arquiteto-de-empresa in your project.

What does Arquiteto De Empresa need to run?

Going by SKILL.md and its folder, Arquiteto De Empresa needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Arquiteto De Empresa access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Arquiteto De Empresa safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Arquiteto De Empresa use?

Arquiteto De Empresa is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Arquiteto De Empresa use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.9k tokens, read only when the agent opens those files.

What are the alternatives to Arquiteto De Empresa?

Skills that share tags, products or a category with Arquiteto De Empresa: Knowledge Base For Startups (aws/agent-toolkit-for-aws, 2.8k stars), Knowledge Search (dataelement/bisheng, 12k stars), Capture Conversation (outline/outline, 41k stars) and Find And Cite (outline/outline, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arquiteto De Empresa?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,938 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.