Skip to content

Skills System ​

Overview ​

Cici Agent completes various automation tasks through 21 skills.

Skill Categories ​

Search (2) ​

search_notes ​

Search notes by keywords.

json
{
  "name": "search_notes",
  "parameters": {
    "query": "search keywords",
    "category": "category (optional)",
    "tags": ["tag list (optional)"]
  }
}

Search notes semantically.

json
{
  "name": "semantic_search",
  "parameters": {
    "query": "description of search intent"
  }
}

Reading (4) ​

read_note ​

Read the content of a single note.

list_notes ​

List notes.

list_categories ​

List the category tree.

list_tags ​

List tags.

Editing (3) ​

edit_note ​

Edit note content.

json
{
  "name": "edit_note",
  "parameters": {
    "note_id": "note ID",
    "content": "new content",
    "operation": "replace|append|prepend"
  }
}

rewrite_note ​

Rewrite a note to make it more concise, more detailed, or change its style.

merge_notes ​

Merge multiple notes into one.

Creation (3) ​

create_note ​

Create a new note.

create_category ​

Create a new category.

create_tag ​

Create a new tag.

Deletion (1) ​

delete_note ​

Delete a note.

Analysis (4) ​

summarize ​

Summarize note content.

extract_keywords ​

Extract keywords.

answer_question ​

Answer questions based on note content.

translate ​

Translate note content.

Organization (4) ​

move_note ​

Move a note to another category.

add_tags ​

Add tags to a note.

remove_tags ​

Remove tags from a note.

favorite_note ​

Favorite or unfavorite a note.

Skill Execution ​

Automatic Invocation ​

Cici automatically selects suitable skills based on user requests:

User: "Search for notes about AI"
→ Cici selects the search_notes skill
→ Executes the search
→ Returns results

Combined Invocation ​

Complex tasks combine multiple skills:

User: "Find all unfinished notes and summarize them"
→ list_notes (get notes)
→ filter (select unfinished notes)
→ summarize (summarize)
→ return results

Skill Priority ​

When multiple skills are available, Cici selects them in this priority order:

  1. Exact match: The skill description best matches the request
  2. Execution cost: Prefer simpler skills
  3. Historical success rate: Prefer skills with higher success rates

Error Handling ​

Skill Execution Failure ​

json
{
  "status": "error",
  "error": "error message",
  "retryable": true
}

Automatic Retry ​

Retryable errors are automatically retried up to 3 times.

Best Practices ​

Clear Instructions ​

Give Cici clear instructions to help it choose the correct skill.

Step-by-Step Execution ​

For complex tasks, provide step-by-step instructions to improve accuracy.

Check Results ​

After skill execution, check whether the results meet expectations.

Troubleshooting ​

Q: Skill execution failed ​

Check the error logs and confirm that the parameters are correct.

Q: Skill response is slow ​

  • Check AI service connection
  • Check database performance
  • Reduce the amount processed in a single request

Q: Skill results are inaccurate ​

  • Adjust query parameters
  • Use more precise descriptions
  • Try another skill