macro-analysis

Macroeconomic cycle positioning and central-bank policy interpretation, including GDP/CPI/PMI/rates/FX analysis, with output in the form of major-asset allocation tilts.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./agent/src/skills/macro-analysis/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with concrete thresholds, a sequenced four-step workflow, and a copy-ready output template, but it is monolithic — no bundle/reference files split out detailed reference content, and some inline context re-explains domain knowledge Claude already has.

Suggestions

Move the detailed indicator threshold tables and central-bank policy-tool references into a references/ file (e.g. INDICATORS.md, POLICY.md) and signal them one level deep from SKILL.md to improve progressive disclosure.

Trim definitional asides Claude already knows ('Excludes food and energy', explanations of the pork cycle and countercyclical adjustment) to tighten conciseness.

Add an explicit validation/verification checkpoint in the workflow (e.g., cross-check cycle stage against all three economies and reconcile conflicting signals before finalizing the allocation tilt).

Dimension	Reasoning	Score
Conciseness	The body is mostly tight and table-driven (indicators, thresholds, policy tools) but explains some domain context Claude already knows and could be trimmed — e.g., 'pork cycle' notes, Merrill Lynch clock prose, and definitional lines like 'Excludes food and energy' and 'countercyclical adjustment'.	2 / 3
Actionability	It gives concrete, copy-ready guidance throughout: numeric thresholds ('>50 = expansion', 'core PCE > 2.5% -> tightening bias'), named decision criteria, and a fill-in output-format template with example rows, so Claude knows exactly what to produce.	3 / 3
Workflow Clarity	The 'Analysis Framework' lays out a clear four-step sequence (Data Collection -> Cycle Positioning -> Policy Impact -> Asset Allocation Tilt) with explicit decision criteria, and the output format template acts as a verification checklist, providing a feedback loop for the produced analysis.	3 / 3
Progressive Disclosure	Sections are well-organized with clear headers and tables, but everything lives inline in one ~190-line SKILL.md with no reference/bundle files (the references/, scripts/, assets/ directories are absent), so the detailed indicator/policy tables that could be split out are not separated one level deep.	2 / 3
	Total	10 / 12 Passed

Description

62%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and distinctive, naming the domain, key inputs, and output form, but it omits any explicit 'Use when...' trigger and leans on specialist jargon over natural user phrasings.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when assessing the macroeconomic cycle, central-bank policy stance, or major-asset allocation tilts') to lift completeness to 3.

Soften jargon with natural trigger terms a user would actually say, such as 'macro analysis', 'rate outlook', or 'where are we in the business cycle', to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions/inputs: 'cycle positioning', 'central-bank policy interpretation', 'GDP/CPI/PMI/rates/FX analysis', and 'major-asset allocation tilts' as output, matching the multi-action anchor.	3 / 3
Completeness	It clearly answers what the skill does but lacks any 'Use when...' or equivalent explicit trigger clause, so the 'when to use' guidance is only implied — capped at 2 per the rubric guideline.	2 / 3
Trigger Term Quality	It surfaces relevant analyst vocabulary (GDP/CPI/PMI/rates/FX, asset allocation) but leans jargon-heavy and omits natural phrasings a user might say ('macro analysis', 'where are we in the cycle', 'rate outlook'), so it has some keywords but missing common variations.	2 / 3
Distinctiveness Conflict Risk	The macroeconomic-cycle and central-bank-policy niche with explicit output form (asset-allocation tilts) is a clear, distinctive domain unlikely to trigger for unrelated skills.	3 / 3
	Total	10 / 12 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: HKUDS/Vibe-Trading
Path: agent/src/skills/macro-analysis/SKILL.md
Commit: 8643fcd

Reviewed: 2 days 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.