Skills
Skills are reusable procedures that define how Wovly handles specific types of tasks. Think of them as playbooks - custom workflows tailored to your communication style and needs.
What Are Skills?
Skills are markdown files that describe:
- When to use the skill (trigger conditions)
- What steps to follow
- How to communicate in each step
- Templates for common messages
# Email Drafting Skill
## Trigger
When the user asks to draft or send an email.
## Steps
1. Identify the recipient and purpose
2. Check conversation history for context
3. Draft the email matching the user's voice
4. Present for approval before sending
## Guidelines
- Match formality to the relationship
- Keep subject lines concise
- Include relevant context from recent conversations
Built-in Skills
Wovly comes with several pre-configured skills:
| Skill | Description |
|---|
| Email Drafting | Smart email composition with voice matching |
| Meeting Scheduling | Back-and-forth availability negotiation |
| Research | Web research and data gathering |
| Follow-up | Persistent outreach campaigns |
Viewing Skills
Go to the Skills page to see all available skills:
- View skill details and procedures
- Edit built-in skills to customize
- Create new custom skills
Creating Custom Skills
Step 1: Create New Skill
- Go to Skills page
- Click Create
- Give it a descriptive name
Step 2: Define the Skill
Use markdown to define the procedure:
# Vendor Outreach
## Description
Contact service providers to request quotes and availability.
## Trigger
When the user asks to contact vendors, contractors, or service providers.
## Steps
1. Identify the type of service needed
2. Use web research to find local providers if not specified
3. Collect contact information
4. Draft personalized emails using the template below
5. Present draft for approval
6. Send emails upon approval
7. Track responses and follow up after 3 days if no reply
## Templates
### Initial Contact
```
Subject: Quote Request for [Service Type]
Hi,
I'm looking for a [service type] provider in [location].
Could you please let me know your availability and pricing?
Here's what I need:
- [Specific requirements]
- Preferred timeframe: [timeframe]
Thank you,
[User Name]
```
## Guidelines
- Be professional but friendly
- Include specific requirements for accurate quotes
- Follow up no more than 3 times
Step 3: Save
Click Save to create the skill. It’s immediately available for use.
Skill Variables
Use variables in templates that get replaced at runtime:
| Variable | Description |
|---|
[User Name] | Your name from profile |
[User Email] | Your email address |
[User Phone] | Your phone number |
[Recipient] | The message recipient |
[Today] | Current date |
[Subject] | Inferred subject/topic |
How Skills Are Used
Automatic Selection
Wovly automatically selects the appropriate skill based on your request:
You: Email the plumbers about the leak
Wovly: [Uses "Vendor Outreach" skill]
I'll draft emails to the plumbers using the vendor outreach template...
Manual Override
You can specify which skill to use:
You: Use the research skill to find information about X
Editing Skills
Modify Built-in Skills
Built-in skills can be customized:
- Click on a skill
- Click Edit
- Modify the markdown
- Click Save
Changes to built-in skills are stored locally and won’t be overwritten by updates.
Restore Default
To restore a built-in skill to its original:
- Click on the skill
- Click Restore Default
Sharing Skills
Skills are stored in ~/.wovly-assistant/skills/ as markdown files.
To share a skill:
- Navigate to
~/.wovly-assistant/skills/
- Copy the
.md file
- Share via email, GitHub gist, etc.
To import a skill:
- Save the
.md file to ~/.wovly-assistant/skills/
- Restart Wovly
- The skill appears in the Skills page
Best Practices
Keep skills focused - One skill should handle one type of task
Write clear triggers - Good triggers help Wovly know when to use the skill
Include templates - Templates ensure consistent, high-quality output
Document edge cases - Use the Guidelines section for unusual situations
