CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nginx-config-generator

Generate Nginx reverse proxy configurations with SSL/TLS (Let's Encrypt), static file serving, upstream definitions, rate limiting, gzip compression, security headers, and location blocks.

Quality

80%

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 ./infrastructure/nginx-config-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, action-dense body: complete and immediately usable Nginx configurations with well-signposted sections, minimal filler, and a coherent scaffold-to-verify progression. The only notable improvements are trimming generic commands Claude already knows and moving a few advanced patterns to reference files for progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dominated by complete, comment-annotated config blocks with essentially no concept explanation and no padding — it assumes Claude's competence throughout. It is not a 5 because the 'Common Commands' section reiterates basics Claude already knows (e.g. 'nginx', 'nginx -s stop', 'tail -f /var/log/nginx/access.log'), which is minor over-explanation that could be trimmed to the non-obvious entries (nginx -t, docker compose exec variants, certbot).

4 / 5

Actionability

Every pattern is fully executable, copy-paste-ready configuration: a complete main nginx.conf, a full reverse-proxy vhost with SSL/WebSocket/SPA/static locations, four ready-to-include snippets, load-balancing upstreams, a static server, and a working certbot Docker setup with the exact certonly command. These cover the common cases for the domain, matching the score-5 anchor.

5 / 5

Workflow Clarity

A discernible sequence runs through the document — scaffold directories, project structure, conventions, then patterns, with 'nginx -t' present as a syntax-test command and reload ('nginx -s reload', 'no downtime') right beside it, plus CI validation noted in Integration Notes. It is not a 5 because there is no explicit 'validate with nginx -t before reloading' step or error-recovery loop; validation is present but implicit rather than a sequenced checkpoint. It is not a 3 because the validation commands are included and ordered alongside the reload operation.

4 / 5

Progressive Disclosure

There are no bundle files, and the single SKILL.md is cleanly sectioned (Prerequisites, Scaffold, Project Structure, Key Conventions, Essential Patterns, Common Commands, Integration Notes), making it easy to navigate with nothing buried. It is not a 5 because at ~330 lines several self-contained advanced patterns (load balancing, static server, certbot Docker workflow) could be split into one-level-deep reference files to slim the always-loaded body.

4 / 5

Total

17

/

20

Passed

Description

71%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 specific, capability-rich description that clearly communicates what the skill generates, with good natural trigger keywords anchored by the Nginx tool name. Its main weakness is the complete absence of a 'when to use' clause, which caps completeness and slightly weakens its trigger and distinctiveness value.

Suggestions

Add an explicit trigger clause, e.g. 'Use when configuring Nginx as a reverse proxy, setting up HTTPS/SSL for a domain, adding rate limiting or security headers, or serving static files behind Nginx.'

Include common synonyms users would say to raise trigger coverage: 'HTTPS', 'TLS certificates', 'load balancing', and 'certbot' alongside 'Let's Encrypt'.

DimensionReasoningScore

Specificity

The description lists seven concrete, distinct capabilities — 'reverse proxy configurations with SSL/TLS (Let's Encrypt)', 'static file serving', 'upstream definitions', 'rate limiting', 'gzip compression', 'security headers', and 'location blocks' — which is comprehensive coverage of the domain and matches the score-5 anchor ('Lists multiple specific concrete actions; comprehensive coverage'). It is not a 4 because there are no meaningful gaps: the actions span configuration, serving, proxying, and hardening. It uses third-person voice ('Generate...').

5 / 5

Completeness

It clearly answers 'what' (concrete list of generation capabilities) but contains no 'when' — there is no 'Use when...' clause or any equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is not a 2 because the 'what' is specific and multi-faceted rather than vague.

3 / 5

Trigger Term Quality

Natural trigger terms are present — 'Nginx', 'reverse proxy', 'SSL/TLS', 'Let's Encrypt', 'rate limiting', 'gzip compression', 'security headers' — which users would genuinely say when needing this skill. It falls short of the score-5 anchor because common synonyms and variations are missing, such as 'HTTPS', 'TLS certificates', 'load balancing', and 'certbot'.

4 / 5

Distinctiveness Conflict Risk

'Nginx' plus 'reverse proxy configurations' establishes a clear, tool-specific niche with minimal conflict risk. It is not a 5 because several listed capabilities (rate limiting, gzip compression, security headers, SSL) could also apply to closely related skills such as docker-compose or Kubernetes Ingress generation, creating minor overlap risk.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

achreftlili/deep-dev-skills

Path

infrastructure/nginx-config-generator/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.