Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
skills
What it is
Part of the agent sessions feature. Skill discovery and reading for AI
agents: skills are markdown documents (document sub type skill) whose
instructions an agent follows when the skill is referenced in its input.
Start here
src/lib.rsmodule doc: the crate's architecture summary (domain/inbound/outbound).src/domain/ports.rs+src/domain/service.rs:SkillServiceand its default implementation.src/inbound/toolset.rs: the three AI tools —search_skills.rs,list_skills.rs,read_skill.rs.src/domain/selection.rs:select_skills, the Jev router agents use to load the user's skills a request needs (agent.skill_selectionspan). Design:docs/architecture/agent-skills.md.src/outbound/:document_skill_reader.rs(reads skill content),search_service_searcher.rs(search),soup_skill_lister.rs(listing).
Scope
- Owns: skill discovery/search/read as AI tools and their adapters.
- Not here: the skill document's own editor/storage surface →
documents; how it's injected into a prompt → the agent harness.
Boundaries
- Depends on:
document_sub_type,entity_access(ports);outboundfeature additionally needsdocuments,search_service_client,soup,lexical_client,item_filters,filter_ast. - Used by:
ai_tools,agent_inmem(skill routing). Descriptions come fromdocuments(skill_descriptions); system skills have none.
Recipes
- Add a skill tool:
src/domain/ports.rs(port method) →src/domain/service.rs→src/inbound/toolset/<name>.rs→ register insrc/inbound/toolset.rs.
Checks
cargo test -p skills(SQLX_OFFLINEunset).
Related
- Skill:
create-ai-tool,cloud-storage-hexagonal-architecture