freehire-search

Use this skill to search live software / tech / data / engineering job listings across many countries and markets (and remote) via the freehire.me aggregator's public API, or to look up a specific posting. It aggregates roles from ~50 ATS platforms into one schema, so a single skill covers many markets — but its faceted filtering (skills, category, seniority) is tuned tech-first, so scope triggers to technical roles. Trigger phrases: find a tech job, software job search, developer jobs, engineering vacancies, data/ML jobs, DevOps roles, remote developer jobs, "are there any <tech role> jobs in <place>", look up this freehire job posting.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

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

A highly actionable, well-organized skill body with concrete commands, examples, and honest error/partial-data guidance. The main weakness is the tangential self-hosting section, which inflates token cost without aiding normal use.

Suggestions

Trim or relocate the self-hosting section (Docker/PostgreSQL/Meilisearch setup and the resource-heavy mirror caveat) to a separate reference file, since it is not needed to run search/detail against the hosted API.

Consider moving the full facet-vocabulary reference (region/country/seniority/category values) into a bundled references file with a one-line pointer, keeping SKILL.md as a lean overview.

Add a short explicit 'validate the result' checkpoint (e.g. check meta.count and stderr error code before acting on results) to nudge workflow_clarity toward the top anchor.

Dimension	Reasoning	Score
Conciseness	The command, flag, example, and partial-data sections are efficient and API-specific, but the ~25-line self-hosting section (Docker Compose, PostgreSQL, Meilisearch, and the resource-heavy mirror caveat) is tangential to using a search CLI and could be tightened or moved out.	3 / 5
Actionability	Fully executable copy-paste CLI commands with a complete flag reference and six concrete examples covering common cases (senior backend, remote React EU, DevOps Germany, ML/AI, plain-text descriptions, detail lookup).	5 / 5
Workflow Clarity	Clear search-vs-detail sequencing with explicit error-handling checkpoints (429/5xx backoff, unreachable API exits non-zero, 404 reported as an error not an empty set); as a read-only skill it has no destructive/batch cap, but it lacks a formal validate-fix-retry loop.	4 / 5
Progressive Disclosure	No bundle files exist, so all content lives in one well-sectioned SKILL.md; structure is good with no nested references, but at ~183 lines with reference-style facet vocabularies inlined it is a touch above the simple-skill threshold rather than an overview pointing to split materials.	4 / 5
	Total	16 / 20 Passed

Description

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

A strong, well-scoped description that concretely states what the skill does and gives rich natural trigger phrases. It is slightly light on enumerating several distinct capabilities and has minor overlap with sibling job-search skills.

Dimension	Reasoning	Score
Specificity	Names the domain and two concrete actions ('search live ... job listings', 'look up a specific posting') but does not enumerate several specific actions, so it sits at the 1-2-actions anchor rather than the several-actions anchor above.	3 / 5
Completeness	Explicitly answers both what ('search live ... job listings ... via the freehire.me aggregator's public API, or to look up a specific posting') and when (concrete 'Trigger phrases:' list plus 'Use this skill to'), matching the explicit-trigger-phrases anchor.	5 / 5
Trigger Term Quality	Provides a comprehensive list of natural trigger phrases a user would actually say ('find a tech job', 'software job search', 'developer jobs', 'DevOps roles', 'remote developer jobs', "are there any <tech role> jobs in <place>"), covering synonyms and phrasings.	5 / 5
Distinctiveness Conflict Risk	It carves a clear freehire.me / tech-roles niche with a distinct lookup trigger ('look up this freehire job posting'), but overlaps conceptually with other job-search skills (e.g. linkedin-search), so minor overlap risk keeps it just below the minimal-conflict anchor.	4 / 5
	Total	17 / 20 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
allowed_tools_field	'allowed-tools' contains unusual tool name(s)	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: MadsLorentzen/ai-job-search
Path: .agents/skills/freehire-search/SKILL.md
Commit: fd89eac

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.