Tools and skills

The tools Clarity agents call and the skills they load.

An agent sees a tool only if its profile allows it. Core tools are attached from the start; deferred tools are listed in an index and attached on demand. Every tool returns the same envelope: an as-of date, the source, the data, citable evidence ids and a short interpretation. A failure returns a typed error (empty, not-found, timeout, rate-limited, …) with a hint, never an exception.

Memory graph

Tool	Use
kg_research	First read for a named subject. Story-first retrieval with causal expansion, in one call.
kg_developments	First read for "what matters now". Ranks developments by corroboration, momentum, freshness, causal weight and materiality.
kg_seed	Resolve tickers and names to entities.
kg_causal_chain	Upstream or downstream causal tree with mechanism, strength and lag, strongest chains first and as deep as they stay strong.
kg_timeline	Ordered developments and state changes, with what superseded what.
kg_stories, kg_expand, kg_path, kg_crawl	Browse stories, neighbourhoods and paths.
kg_evidence	Fetch evidence rows by id (used for checking).
kg_scenario	Propagate a hypothetical shock until its effect fades.
kg_propose	File a sourced candidate fact for review. Not citable until applied.
private_investment_evidence	Evidence from a holder's private documents.

Every graph tool accepts an as-of date. See Memory, time and cause.

Markets, portfolios and the house view

Family	Tools
Market data	market_quote, market_history, market_fundamentals, market_risk, market_technicals, market_events, market_overview, market_proxies, company_pack, economic_calendar, prediction_markets
Published reads	market_context (the current market update), asset_context (published company reads)
Portfolio	portfolio_holdings, portfolio_window, portfolio_prior_analyses, portfolio_analysis
Analytics	illio_portfolio_analytics, illio_portfolio_insights, illio_scenario, illio_holding_analytics, illio_instrument_insights, illio_index_insights, illio_portfolio_series
News and web	news_search, news_recent, news_brief, web_research (three calls per run), fund_factsheet
House view	house_view_read, house_thesis_list, house_theme_read; house_thesis_propose, house_thesis_evolve, house_thesis_retire (proposals need central approval)
Investor	investor_context, investor_thesis_propose (never saves on its own)

Kernel tools (free)

submit_answer, delegate, board_post, board_read, board_ask, workspace_read, workspace_grep, load_skill, search_tools, load_tools, update_plan, memory_read, memory_write. These do not count toward the tool budget. See Agent harness.

Side effects

Class	Meaning	In a run
read	Reads data	Allowed
propose	Drafts a change for a person to approve	Allowed
execute, admin	Changes state	Refused; needs human approval

Skills

A skill is know-how the agent loads when it needs it. One skill is pinned per profile; the rest appear in an index and are read with load_skill.

Skill	Covers
research-method	Order of work across graph, analytics and filings; establishing cause and effect
writing	Lead with the point, plain language, numbers with a yardstick
market-update	The market update: drivers, mechanism, named companies, what changed, what to watch
stock-brief	Company brief: driver, moat, financials, capital allocation, peers, valuation, what breaks it
private-company-brief	Private company: model, traction, rounds, valuation references, risks, checkpoints
portfolio-read	Look-through exposure, what moved, concentration, scenario loss, dated tests
macro-read, sector-read, risk-read	Desk methods
advisor-read, personalization	Suitability and reading the investor's profile and convictions
house-view	The bar for proposing, evolving or retiring a house thesis
verification	Checking a draft against its evidence
delegation	When and how to hand work to a desk
period-review	Weekly, monthly and yearly reviews of what the firm believed and what changed
australia-market	ASX structure, fund codes, RBA and ABS cadence, currency hedging