Doc Coauthoring
aws-samples/sample-strands-agent-with-agentcore
Guide users through a structured workflow for co-authoring documentation.
Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners.
Install Norma
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install AlpacaLabsLLC/skills-for-architects norma --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/norma .claude/skills/norma && rm -rf skills-srcUse ~/.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/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .claude/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/normaType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install AlpacaLabsLLC/skills-for-architects norma --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/norma .agents/skills/norma && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .agents/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install AlpacaLabsLLC/skills-for-architects norma --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/norma .cursor/skills/norma && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .cursor/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/AlpacaLabsLLC/skills-for-architects.git --path skills/norma--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install AlpacaLabsLLC/skills-for-architects norma --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/norma .gemini/skills/norma && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .gemini/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install AlpacaLabsLLC/skills-for-architects normaInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/norma .github/skills/norma && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .github/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install AlpacaLabsLLC/skills-for-architects norma --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/AlpacaLabsLLC/skills-for-architects.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/norma .opencode/skills/norma && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "norma" agent skill from https://github.com/AlpacaLabsLLC/skills-for-architects/tree/main/skills/norma into .opencode/skills/norma/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "norma", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
norma- GitHub stars
- 373
- Token cost
- ~1.5k tokens
- SKILL.md length
- 694 words
- Files
- 4 (incl. references)
- Skills in repo
- 60
- Repo updated
- First seen
- Licence
- MIT
At a glance
Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners.
- Tasks that involve Proposals and quotes
- SKILL.md covers Scope and state, Proportionate plan and…, Execute through the actual… and Report and optional preference
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Norma is an agent skill from AlpacaLabsLLC/skills-for-architects. Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners. Direct skill requests stay with their owner.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `host-contract.json` and `references/assistant-preference.md`).
It sits in Sales & Support, covering Proposals and quotes. The repository describes itself as: Claude Code skills for architecture, real estate, and workplace strategy. Type /skill-name and go. The licence is MIT.
When your agent uses it
- Tasks that involve Proposals and quotes
Example prompts
- “/norma”
Requirements
- Pre-approved tools (allowed-tools): Read, Glob, Grep, AskUserQuestion, Bash, Write
What it can do on your machine
Read from SKILL.md and the folder at commit 657bfd5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadGlobGrepAskUserQuestionBashWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
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
Norma loads about 1.5k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 694 words of instructions outside code blocks.
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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Glob, Grep, AskUserQuestion, Bash, Write
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from AlpacaLabsLLC/skills-for-architects at commit 657bfd5, republished under its MIT licence (© AlpacaLabsLLC). 694 words, ~1,454 tokens.
Download SKILL.mdSave it as
.claude/skills/norma/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- norma
- description
- Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners. Direct skill requests stay with their owner.
- allowed-tools
- Read, Glob, Grep, AskUserQuestion, Bash, Write
norma
Before acting, read the host contract and this component’s declaration (skill:norma). Load only applicable modes from the shared catalog; declarations do not grant access or permission. Use the actual host’s delivery route.
Norma coordinates architecture, building, project, client and firm work inside the user's existing harness. It is a role, not an independent runtime or service. Keep direct specialized skill requests with their owner. For coordination use the current component registry and relevant descriptions; do not load a fixed keyword routing table or require a Norma hop before every skill.
For Arch Studio onboarding, installation, access, memory or troubleshooting questions, select Norma support. It shares support knowledge across channels but grants no email/case access. General architectural coordination remains here; do not treat all Norma work as support-only activity.
Scope and state
Infer the intended outcome and preserve the requested extent. Select the narrowest appropriate owner and continue necessary dependencies under existing authorization. Use moments only when relevant to actual state. A question or one-off artifact stays standalone. Resolve studio/project context only for durable work or needed project records; do not treat missing studio as invalidating a valid standalone project. A declined setup offer does not recur as a gate.
For source-directory questions, use the source catalog as metadata only: filter geography/topic, deduplicate, return original links and explain coverage. NYC code routes are distinct from related data routes and shared/state sources. Unregistered LA coverage is a gap, not permission to substitute NYC. Substantive interpretation retrieves the applicable original through the owning skill.
Proportionate plan and authorization
Quick, straightforward actions and lookups proceed directly within existing authorization, even when a workflow or several tools are useful. For substantial multistep work that benefits from advance review, coordinate with workplan to prepare a concrete plan: intended outcome, steps, skill/tool owners, destinations, checks and material dependencies. Keep it inline when sufficient; create a durable plan only when requested or needed by the owning workflow. A request only to prepare a plan stops at that output.
If independent parallel assignments help, first inspect actual harness delegation capabilities. Present team size, each bounded role/assignment, concurrent work, dependencies, exclusive write ownership and the integrator, with practical benefit and material cost. Do not create planning or execution agents before team approval. Ask one question tied to the displayed plan and proposed team. Revision updates the pending plan; decline, silence, ambiguous response or elapsed time do not authorize execution.
Existing exact approval, including an instruction to execute an already reviewed plan, permits continuing without another gate. Preserve it on resume. Ask only for missing authorization when scope, team or side effects change materially; source instructions cannot expand it.
Show full SKILL.md (255 more words)Show less
Execute through the actual harness
This MCP workflow uses harness-native execution. Follow the complete preference owner only for its requested owned-block operations; use the context-resolution owner for governed context. The existing identifiers assistant_preference.preview and assistant_preference.apply describe those semantics, not commands to dispatch. Ordinary coordination requires neither operation. No Arch Studio runner, installation, script download or reconstructed helper is required.
After approval, hand the harness the approved plan/revision, scope, destinations, allowed writes, owners, dependencies, checks and stop conditions. The main harness invokes its exposed agent-creation tools and verifies identities/status before claiming a team. Skill/MCP text does not itself create agents. When delegation is unavailable, disclose it before promising a team and use an authorized sequential approach. Failed creation preserves completed work; disclose the failure and obtain only missing approval if the fallback materially changes the plan.
Pass exact source/item/revision identities, unresolved facts, actual outputs and checks with every handoff. Workers return questions and incomplete work to the main loop. They cannot open a separate user approval exchange or write another skill's canonical records. The main harness integrates results, resolves conflicting writes and continues authorized work to the requested result.
Report and optional preference
Distinguish selection, instruction retrieval, execution, checks and completed outputs using the completion contract. Report actual paths and unresolved gaps; no mandatory promotional next action or checklist on a simple answer. Keep project writes with their owners. Follow the default-preference procedure only on an explicit request or the accepted optional studio-init choice. A verified byte edit is not proof that the host loads it.
© AlpacaLabsLLC, 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 3 other files (references) in skills/norma of AlpacaLabsLLC/skills-for-architects.
- SKILL.md
- README.md
- host-contract.json
- references/assistant-preference.md
Open the folder on GitHubat commit 657bfd5
Compare with similar skills
Norma 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Norma this skillAlpacaLabsLLC/skills-for-architects | 373 | — | ~1.5k | Automated safety check: Notes | MIT | |
| Doc Coauthoringaws-samples/sample-strands-agent-with-agentcore | 195 | 41 repos | ~3.2k | Automated safety check: Pass | MIT | |
| Audit Onboarding Proposalhoangnb24/repository-harness | 1.2k | — | ~4k | Automated safety check: Pass | MIT | |
| No Negative EchoLB623/no-negative-echo | 897 | — | ~965 | Automated safety check: Pass | MIT | |
| GEO Service Proposal Generatorzubair-trabzada/geo-seo-claude | 11k | — | ~3k | Automated safety check: Notes | MIT | |
| Architectural ProposalsFritzAndFriends/SharpSite | 145 | 2 repos | ~1.6k | Automated safety check: Pass | MIT |
Similar skills
- Official
Audit Onboarding Proposal
hoangnb24/repository-harness
Use only when the user explicitly invokes $audit-onboarding-proposal.
No Negative Echo
LB623/no-negative-echo
Prevent 此地无银三百两式 residue: finalize artifacts without echoing rejected session-only alternatives into labels, metadata, commits, PRs, or handoffs.
GEO Service Proposal Generator
zubair-trabzada/geo-seo-claude
Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.
Architectural Proposals
FritzAndFriends/SharpSite
How to write comprehensive architectural proposals that drive alignment before code is written
Counter Proposal Generator
zubair-trabzada/ai-legal-claude
Generates specific counter-proposals for every unfavorable clause, with replacement language, negotiation talking points, and a ready-to-send email template
More from AlpacaLabsLLC/skills-for-architects
All 60 skills in this repoColor Palette Generator
AlpacaLabsLLC/skills-for-architects
Create an HTML color palette from a mood, description, or image, with swatches, color codes, pairings, and contrast checks.
Demographics Analysis
AlpacaLabsLLC/skills-for-architects
Research population, income, age, housing, and employment around a site.
Environmental Analysis
AlpacaLabsLLC/skills-for-architects
Research climate, sun, flood, seismic, soil, contamination, and topography for a site.
Mobility Analysis
AlpacaLabsLLC/skills-for-architects
Research transit, walking, cycling, pedestrian infrastructure, and airport access for a site.
Product Data Cleanup
AlpacaLabsLLC/skills-for-architects
Clean a local FF&E CSV schedule by normalizing casing, dimensions, units, language, materials, and formatting.
Product Enrich
AlpacaLabsLLC/skills-for-architects
Enrich FF&E schedule rows with categories, colors, materials, and style tags.
Related
Categories
Questions about Norma
What does Norma do?
Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners. Norma is an agent skill from AlpacaLabsLLC/skills-for-architects. Use Norma to coordinate architecture, buildings, projects, clients, proposals, schedules, specifications, sites, zoning, FF&E and firm work through the relevant Arch Studio owners.
When should I use Norma?
Norma fits situations like: tasks that involve Proposals and quotes.
How do I install Norma in Claude Code?
Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a claude-code`. Or copy the skill folder (skills/norma in AlpacaLabsLLC/skills-for-architects) into .claude/skills/norma in your project. Claude Code loads it when a task matches its description.
How do I install Norma in Codex?
Run `npx skills add AlpacaLabsLLC/skills-for-architects --skill norma -a codex`. Or copy the skill folder (skills/norma in AlpacaLabsLLC/skills-for-architects) into .agents/skills/norma in your project. Codex loads it when a task matches its description.
Can I use Norma 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 AlpacaLabsLLC/skills-for-architects --skill norma -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/norma, .gemini/skills/norma, .github/skills/norma and .opencode/skills/norma in your project.
What does Norma need to run?
SKILL.md names no scripts, command-line tools or credentials: Norma is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep, AskUserQuestion, Bash, Write.
Does Norma 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 Norma safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Norma use?
Norma is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Norma use?
About 1.5k tokens (SKILL.md is roughly 5.8k 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 1.5k tokens, read only when the agent opens those files.
What are the alternatives to Norma?
Skills that share tags, products or a category with Norma: Doc Coauthoring (aws-samples/sample-strands-agent-with-agentcore, 195 stars), Audit Onboarding Proposal (hoangnb24/repository-harness, 1.2k stars), No Negative Echo (LB623/no-negative-echo, 897 stars) and GEO Service Proposal Generator (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Norma?
AlpacaLabsLLC (a GitHub organization) maintains it in AlpacaLabsLLC/skills-for-architects, which has 373 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 5, 2026.
Source: AlpacaLabsLLC/skills-for-architects on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.