Name: arquiteto-de-empresa
Rating: 68.8 (1 reviews)
Author: alirezarezvani

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

83%

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

The canonical home for this skill is arquiteto-de-empresa in alirezarezvani/claude-skills

Quality

Content

78%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.

Well-structured, actionable, and appropriately split across references with executable tool commands and a sequenced 12-phase workflow. The main gaps are a missing explicit linter-failure recovery loop and a few trimmable framing sentences.

Suggestions

Add an explicit feedback loop after okf_linter — e.g. 'If okf_linter reports violations, fix the offending concept files and re-run before advancing' — to raise workflow_clarity from 4 to 5.

Tighten the opening persona sentence ('a senior chief of staff who combines in a single agent a business strategist, CFO, CMO, COO, and systems architect') to reduce conciseness overhead without losing the role framing.

Inline one short example of a generated concept (path + frontmatter type) in the body so the core actionability is fully demonstrated without requiring a reference round-trip.

Dimension	Reasoning	Score
Conciseness	Dense and mostly efficient with little explanation of general concepts Claude already knows; only minor instances could be trimmed (e.g. the 'senior chief of staff who combines... strategist, CFO, CMO, COO' framing).	4 / 5
Actionability	Provides concrete, copy-paste-ready commands (scaffold_bundle.py, okf_linter.py, index_generator.py) and a numbered 'How to start' sequence, though the per-phase question/concept detail is delegated to references rather than shown inline.	4 / 5
Workflow Clarity	Clear 12-phase ordering with validation checkpoints (confirm before generating, okf_linter after writing, 'Stop and wait' for answers) and a recommended flow, but it lacks an explicit error-recovery loop stating what to do when okf_linter fails.	4 / 5
Progressive Disclosure	A clear overview body pointing to well-signaled, one-level-deep references (okf_conformance.md, type_vocabulary.md, phase_playbook.md) and assets (templates, example bundle), all of which exist as real files; navigation is easy.	5 / 5
	Total	17 / 20 Passed

Description

88%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.

A strong, third-person description that pairs concrete capabilities with an explicit trigger clause and varied natural keywords. Its only weakness is mild overlap risk on the knowledge-base/wiki phrasings and one jargon term (OKF).

Dimension	Reasoning	Score
Specificity	Lists multiple 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') plus a comprehensive enumeration of all 12 phases, giving broad coverage rather than a few actions.	5 / 5
Completeness	Explicitly answers both what (builds an OKF bundle, runs a 12-phase interview, generates conformant markdown) and when, with a dedicated 'Trigger when...' clause containing concrete trigger phrases.	5 / 5
Trigger Term Quality	Good coverage of natural phrases ('build my company from scratch', 'company as code', 'company wiki for agents', 'knowledge bundle') and the .md extension, but 'OKF'/'Open Knowledge Format' is jargon-only and a few common variations are absent.	4 / 5
Distinctiveness Conflict Risk	The OKF-bundle / company-as-code framing is a clear niche with distinct triggers, but 'company knowledge base for AI to read' and 'company wiki for agents' carry minor overlap risk with general documentation/wiki skills.	4 / 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/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.