Skip to content
SkillMixed1,440 tokens in use

ctf-similar-search

Searches for similar CTF challenge writeups through the Tavily API and extracts page content, to find reference solutions when you are stuck.

3,753 stars on the repository MIT Licenseljagiello/ctf-skills · ctf-similar-search
npx skills add ljagiello/ctf-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing ctf-similar-search costs

59tokens idle
1,440tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: search.py, search.sh.

Touches

shelldeclared and detectednetworkdetectedwrites filesdeclared and detectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter15/15
  • Structure23/25
  • Examples15/15
  • Output10/15
  • Size15/15
  • Resources7/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 20
  • Runs shell commands−2

    does this on the machine, as the frontmatter declares

    SKILL.md, line 20
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    search.py, line 15

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity88
  • Maintenance48
  • Community56
  • Maturity32
  • Momentum40

ctf-similar-search helps an agent find writeups of challenges similar to the one it is working on. It wraps the Tavily search and extract APIs in a small shell and Python helper and gives rules for writing queries that return CTF writeups.

Queries for competition and challenge names are limited to three words, while code snippets and unique strings are exempt. The agent reviews the results first and extracts only the pages that look relevant.

What You Get

  • A search.sh and search.py helper with search and extract commands for the Tavily API
  • Query rules for competition and challenge names, bare challenge names and unique strings
  • A four-step workflow: search, review results, extract selectively, then analyze and pivot
  • Guidance on when to switch to category skills, OSINT or the writeup skill

Common Use Cases

  • Finding the original writeup of a past competition challenge that resembles the current one
  • Identifying a challenge type when only a name or a code fragment is known
  • Looking up how others solved a challenge after several failed attempts

What Makes It Unique

It is the only skill in the collection that reaches outside the repository for reference material. The helper enforces the three-word limit on non-code queries in code, which keeps results on CTF writeups and away from broad vulnerability explainers, and it prints the credits each call used.

Under The Hood

The skill runs a shell script that calls a Python script. The Python script reads a Tavily API key from an environment variable and sends the search query or the URLs to the Tavily search and extract endpoints over the network with the requests package, then prints the results. The user supplies the key and installs the requests and tavily packages. The query text and URLs leave the machine for that third-party service.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers