CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentdb-learning

Create and train AI learning plugins with AgentDB's 9 reinforcement learning algorithms. Includes Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more. Use when building self-learning agents, implementing RL, or optimizing agent behavior through experience.

Quality

69%

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 ./.claude/skills/agentdb-learning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 provides a solid CLI quick start and useful configuration examples, but it is padded with explanations of RL concepts Claude already knows, contains non-executable pseudocode in its advanced sections, and lacks validation feedback loops for its database/batch operations. Restructuring into reference files would address both length and navigation.

Suggestions

Remove or drastically compress the 9-algorithm catalog — Claude already knows what Q-Learning, SARSA, and federated learning are; keep only the AgentDB-specific configuration schemas and CLI commands, ideally moved into a separate references/ file per algorithm.

Fix the non-executable code blocks: replace invalid calls like `sampleRandomBatch(replayBuffer, batchSize: 32)` and `collectBatch(size: 1000)` with valid syntax, define or stub `computeEmbedding`/`runEpisode`, and give the "Slow training" troubleshooting entry an actual command instead of comments only.

Add explicit validation checkpoints to the training workflow (e.g., check valLoss after training and retry with a lower learning rate), since batch inserts and database writes require a validate-fix-retry loop; also delete the duplicated "CLI Operations" section that repeats the Quick Start verbatim.

DimensionReasoningScore

Conciseness

The ~170-line algorithm catalog restates well-known properties of Q-Learning, SARSA, curriculum, federated, and multi-task learning (e.g., "Proven, simple, works well for small/medium problems") that Claude already knows, the "CLI Operations" section repeats Quick Start commands verbatim, and version pins ("AgentDB v1.0.7+") plus marketing claims ("10-100x faster", "500x faster") pad the doc. Several unnecessary explanations match anchor 2 rather than anchor 3's "mostly efficient".

2 / 5

Actionability

CLI commands are copy-paste ready, but key code blocks are non-executable pseudocode: `sampleRandomBatch(replayBuffer, batchSize: 32)` and `collectBatch(size: 1000)` use invalid call syntax, `computeEmbedding`, `runEpisode`, and `getNewExperiences` are undefined, and the "Slow training" fix contains only comments with no actual command. This mix of executable guidance and pseudocode matches anchor 3.

3 / 5

Workflow Clarity

The "Collect Experiences → Train Model → Evaluate Performance" sequence is clear, but validation is only implicit (validationSplit buried in a code sample) with no validate-fix-retry feedback loop. Since the workflow involves database writes and batch inserts, the rubric's cap for missing feedback loops in batch/database operations applies, holding this at anchor 3.

3 / 5

Progressive Disclosure

Section headers are well organized, but the skill is monolithic: per-algorithm configuration details and the training guide are inlined when they belong in separate reference files, and the only pointer ("See docs/algorithms/ for detailed papers") references a path with no corresponding file in the bundle. This fits anchor 3's "some structure... content that should be separate is inline" rather than anchor 2, since clear headers and navigation exist.

3 / 5

Total

11

/

20

Passed

Description

83%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 is strong: it states concrete capabilities with named algorithms and an explicit, natural "Use when" trigger clause covering three scenarios. Its only weaknesses are minor — a few missing trigger synonyms and slight overlap risk with generic RL/ML skills.

DimensionReasoningScore

Specificity

Lists concrete actions ("Create and train AI learning plugins") and names four specific algorithms (Decision Transformer, Q-Learning, SARSA, Actor-Critic), giving several specific capabilities with minor gaps — deploy/evaluate actions from the body are absent. It exceeds the 1-2 concrete actions of anchor 3 but lacks the comprehensive action coverage of anchor 5.

4 / 5

Completeness

Explicitly answers both questions: the "what" ("Create and train AI learning plugins with AgentDB's 9 reinforcement learning algorithms. Includes Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more") and the "when" ("Use when building self-learning agents, implementing RL, or optimizing agent behavior through experience") with three concrete trigger phrases, matching the anchor-5 pattern exactly.

5 / 5

Trigger Term Quality

The "Use when" clause includes natural phrases users would say: "building self-learning agents", "implementing RL", "optimizing agent behavior through experience". Coverage is good but misses common variations like "reward", "policy", or "train an agent", so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The "AgentDB's" plugin system and named RL algorithms establish a clear niche with distinct triggers. However, the broad trigger "implementing RL" could overlap with a general reinforcement-learning or ML skill, so it does not fully meet anchor 5's minimal-conflict standard.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (546 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

ruvnet/ruflo

Path

.claude/skills/agentdb-learning/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.