Skip to main content
Teach your agent domain-specific knowledge by creating skills from the dashboard or API.

​
From the Dashboard

  1. Go to Skills in the sidebar
  2. Click Create Skill
  3. Enter a name (lowercase, hyphen-separated)
  4. Write a description explaining when the skill should be used
  5. Add your instructions in the body
  6. Click Save
The skill is immediately available to the agent.

​
From the API

Send a POST request with the full SKILL.md content: 
curl -X POST https://app.meetchar.ai/api/organization-skills \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "---\nname: order-status\ndescription: Check order status and provide tracking info\n---\n\n# Order Status\n\nWhen asked about an order, look up the order ID and report the current status."
  }'

​
Writing Effective Descriptions

The description determines when the agent activates the skill. Be specific about the scenarios it covers.
Less effectiveMore effective
Handle ordersCheck order status, provide tracking links, and explain delivery estimates
Customer supportAnswer questions about return policy, initiate returns, and process exchanges
Help with billingExplain invoice line items, apply promotional credits, and update payment methods

​
Structuring the Body

Organize your instructions so the agent can find what it needs: 
---
name: return-policy
description: Explain return eligibility and process return requests
---

# Return Policy

## Eligibility
- Items within 30 days of delivery
- Unused, original packaging
- Receipt or order number required

## Process
1. Verify the order
2. Confirm item condition
3. Generate return label
4. Process refund to original payment method

## Exceptions
- Final sale items cannot be returned
- Electronics must include all accessories
- Gift cards are non-refundable

​
Testing

After creating a skill, test it by asking the agent a question that should trigger it. If the skill doesn’t activate:
  • Check that the description clearly matches the type of question
  • Verify the name follows the format rules (lowercase, no consecutive hyphens)
  • Ensure there are no validation errors in the dashboard

​
Updating Skills

To modify an existing skill:
  1. Go to Skills and select the skill
  2. Edit the content
  3. Click Save
Changes take effect immediately for new conversations.

​
Next Steps