CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

income-investment

AI Berkshire skill: Income Investment: Durable and Opportunistic Distribution Analysis. Source: skills/income-investment.md.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./codex-skills/income-investment/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 an unusually disciplined research workflow: concrete commands, exact output structure, explicit gates with precedence rules, and a real audit feedback loop. Its main weakness is layering — everything (sector measures, scorecard, report format, audit usage) is inlined in SKILL.md rather than split into one-level-deep reference files, which inflates context cost per invocation.

Suggestions

Move the sector payout-measure table, the qualitative scorecard, and the full 18-section report format into a references/ file (e.g. references/report-format.md), keeping SKILL.md as the workflow overview with well-signaled links.

Consolidate the duplicated setup instructions (the date/cutoff rule and tool-path guidance appear in both the Codex adapter note and Research Discipline) into one place.

Show the expected JSON shape for 'tools/report_audit.py verdict --results' (or point to where it is documented) so the audit step is fully copy-paste executable.

DimensionReasoningScore

Conciseness

The body is dense, prescriptive checklists and tables that assume domain competence (e.g., the sector payout-measure table, the 10-dimension scorecard) with no padding explaining known concepts. Not 5 because of minor redundancy: the 'run date before research' instruction and the tool-path guidance each appear twice (adapter note plus Research Discipline).

4 / 5

Actionability

Fully executable guidance: exact CLI form with parameters, concrete commands ('date', 'python3 tools/financial_rigor.py', 'tools/report_audit.py extract/verdict'), an exact report path pattern, 18 fixed report headings, seven fixed verdicts, and five fixed blocking gates. Copy-paste ready and covering the common cases.

5 / 5

Workflow Clarity

A clearly sequenced 8-step workflow with explicit validation checkpoints: evidence-quality rating (A/B/C) at intake, the INSUFFICIENT DATA gate, blocking gates that override the scorecard before the verdict, and an audit loop with 'Fix failed items and repeat the audit' — matching the validate/fix/retry feedback-loop pattern.

5 / 5

Progressive Disclosure

The body is well-sectioned and navigable, and the related-workflow table signals sibling skills, but ~190 lines are fully inline: the sector payout-measure table, the 10-dimension scorecard, the 18-section report format, and the audit details are all detail that could live in one-level-deep reference files. Structure is present, but content that should be separate is inline.

3 / 5

Total

17

/

20

Passed

Description

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

The description reads as a title plus provenance metadata rather than a capability statement: it names the domain but says nothing about what the skill does or when to invoke it. Natural trigger vocabulary (dividend, yield, payout) is absent, so model-side routing and user-side recognition would both be unreliable.

Suggestions

State concrete capabilities in third person, e.g. 'Analyzes dividend durability, payout coverage (earnings, FCF, sector-specific measures), usable net income, and portfolio fit for income positions'.

Add an explicit trigger clause: 'Use when the user asks about dividend yield, dividend safety/cut risk, income investing, or whether a stock is a yield trap'.

Remove the meta noise ('AI Berkshire skill:', 'Source: skills/income-investment.md') from the description and keep it to what-and-when content.

DimensionReasoningScore

Specificity

The description only names the domain ("Income Investment: Durable and Opportunistic Distribution Analysis") and states a source path; it lists no concrete actions such as analyzing payout coverage, calculating net income, or classifying yield traps. It matches 'names the domain but actions are minimal or generic', not 3, which requires at least 1-2 stated actions.

2 / 5

Completeness

The 'what' is a vague title with no capability statement, and the 'when' is completely missing (no 'Use when...' clause or equivalent). This matches 'has a vague what and no when'; the missing-trigger guidance also caps completeness at 3, which this description falls below.

2 / 5

Trigger Term Quality

Only "income investment" and "distribution analysis" appear; the natural phrases a user would say ("dividend", "dividend yield", "payout", "dividend safety", "passive income") are entirely absent. Not 3 because common variations and synonyms are missing wholesale, leaving one or two domain-level keywords.

2 / 5

Distinctiveness Conflict Risk

"Income Investment: Durable and Opportunistic Distribution Analysis" carves a fairly distinct niche, but with sibling skills like investment-research and portfolio-review and no explicit triggers, a general research request could plausibly route here. Somewhat specific but could still overlap with similar skills.

3 / 5

Total

9

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

xbtlin/ai-berkshire

Path

codex-skills/income-investment/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.