Skip to content

feat: improve logging-best-practices skill quality scores#4

Open
popey wants to merge 1 commit intoboristane:mainfrom
popey:improve/skill-review-optimization
Open

feat: improve logging-best-practices skill quality scores#4
popey wants to merge 1 commit intoboristane:mainfrom
popey:improve/skill-review-optimization

Conversation

@popey
Copy link

@popey popey commented Feb 25, 2026

Hullo @boristane 👋

I ran tessl skill review against the skill at work, and found some straightforward improvements to bring the description and content scores up. Here's the before/after:

agent-skills-2-score-card
Metric Before After Change
Description 33% 100% +67%
Content 73% 100% +27%
Average 53% 100% +47%
  • Expanded frontmatter description with concrete actions (designs canonical log line schemas, configures single-logger patterns, etc.), trigger terms (logging strategy, structured logs, observability), and a Use when... clause
  • Added Output Format section specifying what the skill produces (structured JSON log events)
  • Added numbered Workflow section (configure logger → add middleware → enrich with business context → include environment → validate)
  • Consolidated anti-patterns inline with core principles to reduce redundancy — each principle now notes what to avoid rather than repeating it in a separate section
  • Removed duplicate Guidelines section that repeated the rule file index
  • Added category: observability metadata
  • Net reduction of 30 lines while improving structure and actionability

For disclosure; I work at @tesslio where we build tooling around skills like these. Not a pitch, just saw room for improvement and wanted to contribute.

If you want to run evals yourself, they're free and open here.

Thanks for sharing this! 🙏

Optimised the logging-best-practices skill based on tessl skill review feedback.

| Metric      | Before | After | Change |
|-------------|--------|-------|--------|
| Description |   33%  | 100%  |  +67%  |
| Content     |   73%  | 100%  |  +27%  |
| Average     |   53%  | 100%  |  +47%  |

Changes:
- Expanded frontmatter description with concrete actions, trigger terms, and "Use when" clause
- Added category metadata field
- Added Output Format and numbered Workflow sections
- Consolidated anti-patterns inline with core principles to reduce redundancy
- Removed duplicate Guidelines section that repeated rule file contents
- Net reduction of 30 lines while improving structure and actionability

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant