arquiteto-de-empresa

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.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured overview that points to real reference/asset files, provides executable tool commands, and lays out a clearly sequenced, validated workflow. Only minor conciseness trims would improve it.

Dimension	Reasoning	Score
Conciseness	Mostly lean and assumes Claude's competence (compact principles, tight tool block), with minor over-explanation such as the 'Portability' note and slightly verbose principle phrasing. Not a 5 because a few phrases could be trimmed; clearly above 3 as there is no padding of basic concepts.	4 / 5
Actionability	Fully executable, copy-paste-ready bash commands with real arguments ('python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech'), a concrete recommended flow, and per-phase (a)-(e) steps.	5 / 5
Workflow Clarity	Clear 12-phase sequence with explicit validation ('okf_linter') and a feedback loop (scaffold → interview → write → okf_linter → index_generator), plus 'Stop and wait' checkpoints and a 'How to start' runbook.	5 / 5
Progressive Disclosure	Clear overview body with well-signaled one-level-deep references (3 references + 3 asset templates + an example bundle), all of which resolve to real files; easy navigation.	5 / 5
	Total	19 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states what the skill does and when to trigger it, with concrete natural-language trigger phrases and a distinctive niche. It is slightly verbose but otherwise strong across all dimensions.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — 'builds a business from scratch as an OKF bundle', 'Guides the founder through a 12-phase interview', 'generates the concepts as conformant markdown' — with minor coverage gaps (no scaffold/lint verbs). Not a 5 because it stops short of enumerating the full set of concrete operations, and not a 3 because it names the domain plus multiple specific actions.	4 / 5
Completeness	Explicitly answers both what ('builds a business... as an OKF bundle... 12-phase interview') and when ('Trigger when the user wants to create, structure, or document an entire company in folders and .md files') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural keyword coverage — 'build my company from scratch, company as code, company knowledge base for AI to read, company wiki for agents, OKF, or knowledge bundle' — but a few common synonyms are missing. Not a 5 (not fully comprehensive) and clearly above 3 (well beyond a single generic phrase).	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (company documented as an OKF bundle) with distinct triggers ('OKF', 'knowledge bundle', 'company as code'), making conflict with other skills minimal.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa/SKILL.md
Commit: 19392f7

Reviewed: ~13 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.