English Français العربية

io.github.Shawn5cents/agentskin

السجل الرسمي الذكاء الاصطناعي والوكلاء

The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package agentskin
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • BRAVE_SEARCH_API_KEY سري Brave Search API Key
  • SERPER_API_KEY سري Serper.dev Search API Key
  • TAVILY_API_KEY سري Tavily Search API Key
  • APILAYER_KEY سري MediaStack API Key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AgentSkin
  2. What it does
  3. Quick start
  4. Design rule
  5. Current verification
  6. Runtime
  7. Development
  8. Credits

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.

الأسئلة الشائعة

ما هو io.github.Shawn5cents/agentskin؟

The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.

كيف أثبّت io.github.Shawn5cents/agentskin؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Shawn5cents/agentskin إلى مفتاح API؟

نعم. يتطلب BRAVE_SEARCH_API_KEY, SERPER_API_KEY, TAVILY_API_KEY, APILAYER_KEY، وتضبطها في إعداداته.

هل io.github.Shawn5cents/agentskin مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.Shawn5cents/agentskin؟

ينشره Shawn5cents. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.