tellmefrankie/news-engine/env-doctor

Claude Code and agent skill by tellmefrankie/news-engine

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install tellmefrankie/news-engine/env-doctor

SKILL.md

The same SKILL.md was published earlier as tellmefrankie/news-engine/env-doctor.

Env Doctor

Diagnose your .env file before deployment. Catches the configuration bugs that only show up in production at 2 AM.

What it does

  • Compares .env against .env.example — finds missing vars
  • Detects placeholder values never replaced (..., your-key-here, sk-ant-XXXX)
  • Flags secrets that look wrong (wrong prefix, wrong length, wrong format)
  • Checks for common mistakes: trailing spaces, Windows line endings, BOM markers
  • Warns about vars that exist in .env but not in .env.example (undocumented secrets)
  • Validates known API key formats (Anthropic, OpenAI, Stripe, Polygon, Telegram)

Usage

Run env doctor on this project.
Compare .env against .env.example.
Check for: missing vars, placeholder values, format issues, undocumented secrets.

Example Output

Env Doctor — 2026-05-13
MISSING VARS (in .env.example but not in .env)
POLYGON_API_KEY — required for options scanner
NAVER_CLIENT_SECRET — required for Korean news feed
PLACEHOLDER VALUES (never replaced)
TWITTER_BEARER_TOKEN = "..." — still default
TWITTER_API_KEY = "..." — still default
FORMAT WARNINGS
ANTHROPIC_API_KEY = "sk-ant-api03-..."
OK: correct prefix, length looks right
TELEGRAM_BOT_TOKEN = "1234567890:ABC..."
OK: correct format (number:hash)
POLYGON_API_KEY = ""
WARN: empty string — key exists but has no value
UNDOCUMENTED SECRETS (in .env but not in .env.example)
DEVTO_API_KEY — consider adding to .env.example with placeholder
ENCODING ISSUES
None found (UTF-8, Unix line endings)
SUMMARY
2 missing required vars
2 placeholder vars not replaced
1 undocumented secret
0 encoding issues
Run: cp .env.example .env.local and fill in missing values

Validated API key formats

ServiceExpected formatExample
Anthropicsk-ant-api03-...50+ chars
OpenAIsk-proj-... or sk-...51 chars
Stripesk_live_... or sk_test_...32+ chars
Polygon.ioalphanumeric, 32 chars
Telegram Bot{number}:{hash}1234567890:ABC...
dev.toalphanumeric, 20 chars

Configuration

Run env doctor:
Files: .env vs .env.example
Check format: ANTHROPIC_API_KEY, TELEGRAM_BOT_TOKEN, POLYGON_API_KEY
Required vars: ANTHROPIC_API_KEY, TELEGRAM_BOT_TOKEN, TELEGRAM_CHANNEL_ID
Warn if any var contains: "...", "your-", "xxx", "test", "placeholder"

Common catches

The classic: ANTHROPIC_API_KEY=sk-ant-XXXX — copied from docs, never replaced

The silent fail: DATABASE_URL= — trailing space means the var is a single space, not empty. Some parsers treat this as set.

The Windows trap: .env edited on Windows has \r\n line endings. Some Node.js dotenv parsers include the \r in the value. "mypassword\r" is not "mypassword".

The gitignore miss: .env.production not in .gitignore. Happens when someone adds a new env file variant.

Requirements

  • Read tool access (reads .env and .env.example)
  • No API keys needed — pure text analysis

Free

Fully free and open source.

→ https://github.com/tellmefrankie/news-engine

Author

Built after a production deploy failed because TELEGRAM_BOT_TOKEN was still "..." in the production .env. The env doctor would have caught it in 2 seconds.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/tellmefrankie/news-engine/env-doctor/badge)](https://verified-skill.com/skills/tellmefrankie/news-engine/env-doctor)

Something wrong with this skill or its page? Tell us.