Borrowing it
Nothing to install: this file belongs to PierreJanineh/TechDebtMCP. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/PierreJanineh/TechDebtMCP/develop/.claude/skills/refresh-self-scan/SKILL.mdgit clone --depth 1 https://github.com/PierreJanineh/TechDebtMCPWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/pierrejanineh/techdebtmcp/refresh-self-scan)<a href="https://agentmods.dev/skills/pierrejanineh/techdebtmcp/refresh-self-scan"><img src="https://agentmods.dev/badge/skills/pierrejanineh/techdebtmcp/refresh-self-scan/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/pierrejanineh/techdebtmcp/refresh-self-scan"><img src="https://agentmods.dev/badge/skills/pierrejanineh/techdebtmcp/refresh-self-scan.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00052 | $0.00869 |
| Opus 5.5 | $0.00021 | $0.00348 |
| Sonnet 5.5 | $0.00010 | $0.00174 |
| Haiku 4.5 | $0.00005 | $0.00087 |
Grade A, and why
refresh-self-scan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Refresh Self-Scan
CLAUDE.md declares TECH_DEBT_SCAN.md as the canonical source of truth for the four self-scan metrics. Three derivative documents (README.md Self-Scan Results, ARCHITECTURE.md Current Status, CONTRIBUTING.md Configuration Impact) must agree with it and must be updated in the same commit. This skill performs that synchronization end-to-end.
When to run
After any of:
- A code change that could plausibly move the metrics (new analyzer, new rule, custom-rules engine change).
- A
.techdebtrc.jsonchange. - An MCPB / plugin release where the README is publicly visible.
Do not run as part of routine bug fixes or docs-only PRs — the rule in .claude/rules/docs-maintenance.md only requires a refresh when the numbers actually move.
Procedure
1. Run the scan
Use the locally installed dogfood MCP (tech-debt-mcp-local), not the published package — the published version may lag behind src/.
mcp__tech-debt-mcp-local__analyze_project { path: "<repo-root>" }
mcp__tech-debt-mcp-local__get_sqale_metrics { path: "<repo-root>" }
Capture: Health Score, Debt Score, Total Issues, Remediation Time (and SQALE rating if it changed).
2. Compare against TECH_DEBT_SCAN.md
Read TECH_DEBT_SCAN.md. If any of the four metrics moved by more than the noise threshold (≥0.1 health/debt point, ≥1 issue, ≥5 min remediation), continue. Otherwise stop and report "no change."
3. Update TECH_DEBT_SCAN.md first
TECH_DEBT_SCAN.md is the canonical source — edit it before any derivative file so a partial commit can never produce divergence. Update:
- The four metric values
- "Last Updated" timestamp (ISO date)
- Any top-issue or category-breakdown sections that depend on the scan
4. Propagate to the three derivative files
In the same commit, update:
| File | Block to touch |
|---|---|
README.md |
"Self-Scan Results" block |
ARCHITECTURE.md |
"Current Status" block |
CONTRIBUTING.md |
"Configuration Impact" block |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 75 lines · 52 tokens per session scan A 91c50a6b3fe9
refresh-self-scan is a skill published in the GitHub repository PierreJanineh/TechDebtMCP (7 stars, last pushed 3mo ago), licensed MIT. It adds 52 tokens to every session and 869 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
open-source
Documentation reference for writing Python code using the browser-use open-source library. Use this skill whenever the user needs help with Agent, Browser, or Tools configuration, is writing code that imports from browseruse, asks about @sandbox deployment, supported LLM models, Actor API, custom tools, lifecycle…
repomix
Pack and analyze codebases into AI-friendly single files using Repomix. Use when the user wants to explore repositories, analyze code structure, find patterns, check token counts, or prepare codebase context for AI analysis. Supports both local directories and remote GitHub repositories.
ix
Answer structural questions about a codebase — what a symbol is, what calls it, what a change breaks, where the hotspots are — from a persistent code graph via the ix CLI, instead of grepping.
snip
You are an expert at writing declarative YAML filters for snip, a CLI proxy that reduces LLM token consumption by filtering shell output.
goai
GoAI is a Go SDK for AI applications. One unified API across 25+ LLM providers. Inspired by the Vercel AI SDK, adapted to Go idioms (generics, interfaces, channels).
skill-creator-primer
You MUST load this skill before the skill-creator skill AND before making ANY change to, or conducting a review of ANY Agent Skill. Triggers include creating, editing, reviewing, or contributing to any part of an Agent Skill (description, frontmatter, body, references, scripts, trigger evals, conflicts, etc).