How do I get a Skills IL API key?

Sign in to your profile at agentskills.co.il, click "Create API Key", and copy the key. Every account receives 500 free credits.

How much does the API cost?

Browsing skills (GET /v1/skills) is free. Invoking a skill (POST /v1/invoke) costs 1 credit, and semantic query (POST /v1/query) costs 3 credits. Every account gets 500 free credits.

What endpoints are available?

The API offers 5 endpoints: GET /v1/skills (list skills), GET /v1/skills/:slug (skill details), GET /v1/skills/autocomplete (autocomplete), POST /v1/invoke (invoke a skill), and POST /v1/query (semantic query with vector search).

Does the API support Hebrew?

Yes, the API returns bilingual content (Hebrew and English) for all skills, including names, descriptions, tags, and content.

What are the API rate limits?

The API rate-limits requests per IP and API key. If you receive a 429 error, wait a few seconds and retry.

API Documentation

Integrate Skills IL into your applications with our REST API

Get API Key

Base URL

All API requests should be made to the following base URL:

https://api.agentskills.co.il

Authentication

Authenticate requests using an API key passed in the x-api-key header. Get your key from your profile dashboard.

x-api-key: sk-il_your_key_here

Credits

Each API key comes with credits. Different endpoints cost different amounts.

1per invocation

3per query

500free credits

Pagination

The List Skills endpoint returns paginated results. Use the page and pageSize query parameters to navigate through results.

Name	Type	Default	Description
`page`	number	1	Page number (starts at 1)
`pageSize`	number	12	Results per page (max 50)

The response includes total, page, pageSize, and totalPages fields so you can build pagination controls:

// Response from GET /v1/skills?page=2&pageSize=10
{
  "skills": [...],
  "total": 109,
  "page": 2,
  "pageSize": 10,
  "totalPages": 11
}

Endpoints

GET/v1/skillsPublic

List Skills

Returns a list of published skills with support for filtering, search, and pagination.

Parameters

Name	In	Type	Required	Description
`q`	query	string	No	Search term
`category`	query	string	No	Filter by category slug
`agent`	query	string	No	Filter by supported agent
`tier`	query	string	No	Filter by trust tier (verified, trusted, community, under-review)
`tag`	query	string	No	Filter by tag
`sort`	query	string	No	Sort: popular (default), newest, highest-rated, views
`page`	query	number	No	Page number (default: 1)
`pageSize`	query	number	No	Results per page, 1-50 (default: 12)

Response

{
  "skills": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "israeli-tax-calculator",
      "name_en": "Israeli Tax Calculator",
      "name_he": "מחשבון מס ישראלי",
      "description_en": "Calculate Israeli income tax...",
      "description_he": "חישוב מס הכנסה ישראלי...",
      "category_slug": "tax-and-finance",
      "trust_score": 92,
      "trust_tier": "verified",
      "supported_agents": [
        "claude-code",
        "cursor",
        "github-copilot"
      ],
      "install_command": "npx skills-il add skills-il/tax-and-finance --skill israeli-tax-calculator",
      "install_count": 150,
      "view_count": 1200,
      "avg_rating": 4.5,
      "review_count": 12,
      "tags": [
        "tax",
        "finance"
      ],
      "author_github": "skills-il",
      "github_stars": 45,
      "version": "1.0.0"
    }
  ],
  "total": 109,
  "page": 1,
  "pageSize": 12,
  "totalPages": 10
}

Examples

curl "https://api.agentskills.co.il/v1/skills?category=tax-and-finance&page=1&pageSize=10"

GET/v1/skills/:slugPublic

Get Skill

Returns full details for a skill by slug.

Parameters

Name	In	Type	Required	Description
`slug`	path	string	Yes	Skill identifier

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "israeli-tax-calculator",
  "name_en": "Israeli Tax Calculator",
  "name_he": "מחשבון מס ישראלי",
  "description_en": "Calculate Israeli income tax...",
  "description_he": "חישוב מס הכנסה ישראלי...",
  "content_en": "# Israeli Tax Calculator\n\n## Instructions...",
  "category_slug": "tax-and-finance",
  "trust_score": 92,
  "trust_tier": "verified",
  "trust_breakdown": {
    "codeQuality": 95,
    "permissions": 90,
    "dataHandling": 88
  },
  "supported_agents": [
    "claude-code",
    "cursor",
    "github-copilot"
  ],
  "install_command": "npx skills-il add skills-il/tax-and-finance --skill israeli-tax-calculator",
  "install_count": 150,
  "view_count": 1200,
  "avg_rating": 4.5,
  "review_count": 12,
  "tags": [
    "tax",
    "finance"
  ],
  "author_github": "skills-il",
  "github_stars": 45,
  "github_url": "https://github.com/skills-il/tax-and-finance/tree/master/israeli-tax-calculator",
  "problem_statement": {
    "he": "...",
    "en": "..."
  },
  "when_to_apply": {
    "he": [
      "..."
    ],
    "en": [
      "..."
    ]
  },
  "best_practices": {
    "he": [
      "..."
    ],
    "en": [
      "..."
    ]
  },
  "faq": {
    "he": [
      {
        "q": "...",
        "a": "..."
      }
    ],
    "en": [
      {
        "q": "...",
        "a": "..."
      }
    ]
  }
}

Examples

curl "https://api.agentskills.co.il/v1/skills/israeli-tax-calculator"

GET/v1/skills/autocompletePublic

Autocomplete

Returns autocomplete suggestions for a search query.

Parameters

Name	In	Type	Required	Description
`q`	query	string	Yes	Search term
`limit`	query	number	No	Number of suggestions (default: 5)

Response

[
  {
    "slug": "israeli-tax-calculator",
    "name": {
      "he": "מחשבון מס ישראלי",
      "en": "Israeli Tax Calculator"
    },
    "category_slug": "tax-and-finance"
  },
  {
    "slug": "tax-bracket-advisor",
    "name": {
      "he": "יועץ מדרגות מס",
      "en": "Tax Bracket Advisor"
    },
    "category_slug": "tax-and-finance"
  }
]

Examples

curl "https://api.agentskills.co.il/v1/skills/autocomplete?q=tax&limit=5"

POST/v1/invokeAPI Key Required1 credit

Invoke Skill

Invoke a skill with given input. Requires an API key and costs 1 credit.

Parameters

Name	In	Type	Required	Description
`skill`	body	string	Yes	Skill name (max 200 chars)
`input`	body	object	No	Skill-specific parameters

Response

{
  "success": true,
  "data": {
    "...": "skill-specific output"
  },
  "metadata": {
    "skill": "israeli-tax-calculator",
    "executionTimeMs": 1250,
    "creditsCharged": 1,
    "creditsRemaining": 499
  }
}

Examples

curl -X POST "https://api.agentskills.co.il/v1/invoke" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-il_your_key_here" \
  -d '{"skill": "israeli-tax-calculator", "input": {"salary": 25000}}'

POST/v1/queryAPI Key Required3 credits

Semantic Query

Find the best matching skill for a natural language query using vector search. Requires an API key and costs 3 credits.

Parameters

Name	In	Type	Required	Description
`query`	body	string	Yes	Natural language query (max 2000 chars)
`input`	body	object	No	Parameters passed to the matched skill

Response

{
  "success": true,
  "data": {
    "...": "output from matched skill"
  },
  "metadata": {
    "matchedSkill": "israeli-tax-calculator",
    "similarity": 0.89,
    "executionTimeMs": 2100,
    "creditsCharged": 3,
    "creditsRemaining": 497
  }
}

Examples

curl -X POST "https://api.agentskills.co.il/v1/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-il_your_key_here" \
  -d '{"query": "help me calculate Israeli taxes"}'

Response Format

All endpoints return JSON. Successful responses include the data directly. Errors return an object with an error message.

// Catalog (GET /v1/skills)
{ "skills": [...], "total": 109, "page": 1, "pageSize": 12, "totalPages": 10 }

// Invoke & Query (POST /v1/invoke, POST /v1/query)
{ "success": true, "data": {...}, "metadata": { "creditsRemaining": 499 } }

// Error
{ "error": "Invalid API key" }

Error Codes

Code	Error	Description
`400`	Bad Request	Missing or invalid parameters
`401`	Unauthorized	Missing or invalid API key
`403`	Insufficient Credits	Not enough credits for the operation
`404`	Not Found	The requested skill was not found
`429`	Rate Limited	Too many requests. Try again in a few seconds.

Ready to get started?

Generate an API key from your profile and start building with Skills IL.

Go to Profile