CtrlK
BlogDocsLog inGet started
Tessl Logo

simon/skills

Auto-generated tile from GitHub (10 skills)

92

1.16x
Quality

94%

Does it follow best practices?

Impact

92%

1.16x

Average score across 44 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-41/

{
  "context": "Tests whether the agent applies Diátaxis-style patterns when creating tutorial and reference documentation for a developer library. Criteria cover type-specific title conventions, structural patterns, content rules, document purity, and cross-linking.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Tutorial verb title",
      "description": "The tutorial document's title starts with an imperative verb (e.g., 'Build', 'Create', 'Set up', 'Write', 'Deploy') — NOT 'How to...' and NOT a noun phrase",
      "max_score": 10
    },
    {
      "name": "Tutorial goal intro",
      "description": "The tutorial introduction explicitly states what the user will have or be able to do by the end, framed as an outcome (e.g., 'By the end of this tutorial, you will have...')",
      "max_score": 10
    },
    {
      "name": "Tutorial prerequisites section",
      "description": "The tutorial includes a distinct prerequisites or 'Before you begin' section listing what the reader needs before starting",
      "max_score": 10
    },
    {
      "name": "Tutorial step results",
      "description": "At least 3 of the tutorial's numbered steps include a visible or verifiable result the user can confirm (e.g., expected output, what the user will see, a command whose success is observable)",
      "max_score": 10
    },
    {
      "name": "Tutorial action focus",
      "description": "The tutorial does NOT contain conceptual explanations, design rationale, or 'why' sections — content is action commands and observable results only",
      "max_score": 10
    },
    {
      "name": "Reference noun title",
      "description": "The reference document's title is a noun phrase naming the subject (e.g., 'Configuration Options', 'API Reference', 'CLI Flags') — NOT verb-first and NOT 'How to...'",
      "max_score": 10
    },
    {
      "name": "Reference entry format",
      "description": "Reference entries follow a consistent repeatable format that includes ALL of: parameter/option name, type, default value, and description (example usage is a bonus)",
      "max_score": 15
    },
    {
      "name": "Reference no instructions",
      "description": "The reference document does NOT contain numbered steps, procedural 'do this then that' instructions, or tutorial-style walkthroughs — it states facts only",
      "max_score": 10
    },
    {
      "name": "Document type separation",
      "description": "Tutorial and reference content are in separate files — the tutorial file does NOT contain reference tables of all parameters, and the reference file does NOT contain step-by-step numbered walkthroughs",
      "max_score": 10
    },
    {
      "name": "Cross-link present",
      "description": "At least one document contains a link or explicit reference to the other document (e.g., the tutorial mentions 'see the reference docs' with a path or filename, or the reference links to the tutorial)",
      "max_score": 5
    }
  ]
}

evals

README.md

tile.json