io.github.Shawn5cents/agentskin
The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.
Que pouvez-vous faire avec io.github.Shawn5cents/agentskin ?
compress— one front door that auto-detects JSON, CLI output, or plain text.fetch_optimized_data— fetches a public URL and applies URL-specific pruning rules when available.reduce— compacts terminal output using Tokenjuice's rule-driven reducers.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
agentskinclaude mcp add agentskin -e 'BRAVE_SEARCH_API_KEY=<your brave_search_api_key>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'APILAYER_KEY=<your apilayer_key>' -- npx -y agentskin@4.0.1
{
"mcpServers": {
"agentskin": {
"command": "npx",
"args": [
"-y",
"agentskin@4.0.1"
],
"env": {
"BRAVE_SEARCH_API_KEY": "<your brave_search_api_key>",
"SERPER_API_KEY": "<your serper_api_key>",
"TAVILY_API_KEY": "<your tavily_api_key>",
"APILAYER_KEY": "<your apilayer_key>"
}
}
}
}
Variables d'environnement
BRAVE_SEARCH_API_KEYsecret Brave Search API KeySERPER_API_KEYsecret Serper.dev Search API KeyTAVILY_API_KEYsecret Tavily Search API KeyAPILAYER_KEYsecret MediaStack API Key
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
AgentSkin
Context middleware for AI agents. AgentSkin removes low-value API, JSON, and terminal noise before it enters model context.
The frozen AgentSkin 5.1 offline core evaluation also has an accepted Sparse Env execution path. AgentSkin preserves the workload correctness contract while Sparse Env owns cold/warm environment selection and lifecycle; see agentskin/docs/SPARSE_ENV.md.
What it does
AgentSkin has three primary workflows:
compress— one front door that auto-detects JSON, CLI output, or plain text.fetch_optimized_data— fetches a public URL and applies URL-specific pruning rules when available.reduce— compacts terminal output using Tokenjuice's rule-driven reducers.
Five advanced tools remain for compatibility and diagnostics: apply_json_semantic, classify_url, strip_ansi, estimate_tokens, and skin_reasoning.
Quick start
npx -y agentskin@latest
MCP config:
{
"mcpServers": {
"agentskin": {
"command": "npx",
"args": ["-y", "agentskin@latest"]
}
}
}
Design rule
Fidelity first, compression second. Explicit signals and URL rules are authoritative. Generic keys such as id, name, and url are only fallback signals when no explicit rule exists.
A reduction is useful only when the information required by the task survives it.
Current verification
The release gate runs the AgentSkin-owned test suite, including MCP startup/security and live HTTP integration tests. Run it with:
cd agentskin
npm ci
npm test
Benchmarks are workload-specific. The test suite prints measured reductions for its fixtures instead of claiming one universal savings percentage.
Runtime
- Node.js MCP server over stdio
- Tokenjuice is a normal npm dependency for CLI reduction
- URL-specific semantic pruning rules for structured APIs
- SSRF checks for fetches, response-size limits, rate limiting, Zod validation, and processing timeouts
Development
The npm package lives in agentskin/ inside this repository.
cd agentskin
npm ci
npm test
npm run lint
npm pack --dry-run
Credits
AgentSkin semantic pruning and MCP integration: Shawn Nichols Sr. / Nichols Transco LLC.
CLI reduction uses Tokenjuice by Vincent Koc under its MIT license.
Questions fréquentes
Qu'est-ce que io.github.Shawn5cents/agentskin ?
The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.
Comment installer io.github.Shawn5cents/agentskin ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add agentskin -e 'BRAVE_SEARCH_API_KEY=<your brave_search_api_key>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'APILAYER_KEY=<your apilayer_key>' -- npx -y agentskin@4.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Shawn5cents/agentskin ?
Oui. Il attend BRAVE_SEARCH_API_KEY, SERPER_API_KEY, TAVILY_API_KEY, APILAYER_KEY, à renseigner dans sa configuration.
io.github.Shawn5cents/agentskin est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.Shawn5cents/agentskin ?
Il est publié par Shawn5cents. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.