CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

79

Quality

99%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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-engineered overview: dense one-line principles, executable commands with flags, an explicitly sequenced 12-phase workflow with confirm/lint validation checkpoints, and clean delegation to real, one-level-deep reference and asset files. No padding, no inferred-only steps, and no monolithic content that belongs in bundle files.

DimensionReasoningScore

Conciseness

The ~75-line body is lean and assumes Claude's competence: one-line numbered principles ('Interview before building', 'Lean questions. At most 3 to 5 per block'), a compact three-command code block, and summary rules that delegate full detail to references. It never explains concepts Claude already knows, and every token carries guidance, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Guidance is copy-paste ready: 'python scripts/scaffold_bundle.py "My Company" --out ./my-company --has-product --has-tech', the linter and index-generator invocations, a concrete recommended flow ('scaffold → interview per phase → write concepts → okf_linter → index_generator'), and a numbered startup procedure with exact first actions including 'Stop and wait' for answers. This covers the common cases an executing agent needs.

5 / 5

Workflow Clarity

The multi-step process is explicitly sequenced — the 12-phase chain with conditional skips ('06-produto (skip if pure service)', '08-tech (only if there is digital infrastructure)'), per-phase steps (a)-(e) — and includes real validation checkpoints: 'Confirm before generating... ask for ok' plus running okf_linter after each phase, forming a validate-fix-retry loop for the batch file generation. This matches the anchor with explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

SKILL.md is a true overview with well-signaled, one-level-deep references: conformance rules summarized with 'full detail in references/okf_conformance.md', phase details in phase_playbook.md, the type vocabulary in type_vocabulary.md, and templates under assets/ — every referenced path verified to exist in the bundle. Content is appropriately split and navigation is easy, matching the top anchor.

5 / 5

Total

20

/

20

Passed

Description

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

An exemplary description: it states the what (building a company as a conformant OKF bundle through a 12-phase interview) with concrete, specific actions, and the when with an explicit trigger clause covering natural user phrasings, synonyms, and file extensions. Third-person voice is used throughout and there is no vague filler or over-claiming.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: 'builds a business from scratch as an OKF bundle', 'a tree of version-controllable .md files with frontmatter type, links forming a graph, and reserved index.md/log.md', 'Guides the founder through a 12-phase interview', and 'generates the concepts as conformant markdown'. It is written in third person ('builds', 'guides') and every clause states a concrete capability; anchor 4's 'minor gaps in coverage' does not apply.

5 / 5

Completeness

Both halves are explicit. The 'what' is concrete (builds a business as an OKF bundle via a 12-phase interview generating conformant markdown), and the 'when' opens with 'Trigger when the user wants to create, structure, or document an entire company in folders and .md files' followed by specific user phrases. This matches the anchor requiring explicit what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and natural: 'create, structure, or document an entire company in folders and .md files', 'build my company from scratch', 'company as code', 'company knowledge base for AI to read', 'company wiki for agents', 'OKF', 'knowledge bundle'. Synonyms and the .md file extension are covered, matching the comprehensive anchor rather than the 'a few natural terms missing' anchor.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — whole-company architecture as an OKF .md bundle — with distinct triggers ('OKF', 'company as code', 'company wiki for agents', 'knowledge bundle'). Overlap with generic wiki/documentation skills is minimal because triggers are qualified by 'entire company in folders and .md files', matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.