# OpenCode Skills A collection of reusable skills for [OpenCode](https://opencode.ai) - the AI-powered terminal coding assistant. Skills extend OpenCode's capabilities by providing domain-specific tools and workflows that the AI can leverage to accomplish tasks. ## What are OpenCode Skills? Skills are modular extensions that teach OpenCode how to interact with external services, APIs, and tools. Each skill contains: - **SKILL.md** - A markdown file describing the skill's capabilities, commands, and usage patterns - **Scripts** - Executable scripts (Python, Bash, etc.) that perform the actual operations - **Configuration** - Environment variables and settings needed for the skill to function When you add a skill to your project's `.opencode/skill/` directory, OpenCode automatically learns how to use it based on the SKILL.md documentation. ## Available Skills | Skill | Description | API Required | |-------|-------------|--------------| | [trello-manager](./skills/trello-manager/) | Manage Trello boards, lists, cards, labels, and checklists | Trello API | ## Quick Start ### 1. Install OpenCode If you haven't already, install OpenCode: ```bash # Using npm npm install -g @anthropic-ai/opencode # Or using Homebrew (macOS) brew install opencode ``` ### 2. Add a Skill to Your Project Copy the desired skill folder into your project's `.opencode/skill/` directory: ```bash # Create the skill directory in your project mkdir -p your-project/.opencode/skill # Copy the skill you want to use cp -r opencode-skills/skills/trello-manager your-project/.opencode/skill/ ``` ### 3. Configure the Skill Each skill requires specific configuration. Navigate to the skill's directory and set up the environment: ```bash cd your-project/.opencode/skill/trello-manager/scripts # Copy the example environment file cp .env.example .env # Edit .env with your actual API credentials nano .env # or use your preferred editor ``` ### 4. Use the Skill with OpenCode Start OpenCode in your project directory: ```bash cd your-project opencode ``` Now you can ask OpenCode to use the skill naturally: ``` > Show me all my Trello boards > Create a new card called "Fix login bug" in my To Do list > Move the card to Done when finished ``` ## Project Structure ``` opencode-skills/ ├── README.md # This file ├── LICENSE # MIT License ├── skills/ │ └── trello-manager/ │ ├── SKILL.md # Skill documentation for OpenCode │ └── scripts/ │ ├── trello_api.py # Main API script │ ├── .env.example # Example environment variables │ └── requirements.txt # Python dependencies └── docs/ └── creating-skills.md # Guide for creating your own skills ``` ## Skill Documentation ### Trello Manager Full-featured Trello integration for managing your boards, lists, and cards directly through OpenCode. #### Features - **Board Management**: List all boards, create new boards - **List Management**: View lists, create lists, rename lists - **Card Operations**: Create, move, delete, and update cards - **Labels**: Create labels, add/remove labels from cards - **Checklists**: Create checklists, add items, mark items complete/incomplete #### Setup 1. Get your Trello API credentials: - Go to https://trello.com/power-ups/admin - Create a new Power-Up or use an existing one - Generate an API Key - Generate a Token (click the "Token" link on the API key page) 2. Configure the environment: ```bash cd .opencode/skill/trello-manager/scripts cp .env.example .env ``` 3. Edit `.env` with your credentials: ```env TRELLO_API_KEY=your_api_key_here TRELLO_API_TOKEN=your_token_here ``` #### Commands Reference | Command | Arguments | Description | |---------|-----------|-------------| | `list_boards` | - | Show all your Trello boards | | `create_board` | ` [description]` | Create a new board | | `list_lists` | `` | Show all lists in a board | | `create_list` | ` ` | Create a new list | | `update_list` | ` ` | Rename a list | | `list_cards` | `` | Show all cards in a list | | `get_card` | `` | Get detailed card information | | `create_card` | ` [desc]` | Create a new card | | `move_card` | ` ` | Move card to another list | | `delete_card` | `` | Delete a card | | `update_card_desc` | ` ` | Update card description | | `list_labels` | `` | Show all labels on a board | | `create_label` | ` ` | Create a new label | | `add_label` | ` ` | Add label to a card | | `remove_label` | ` ` | Remove label from card | | `create_checklist` | ` [name]` | Add checklist to card | | `add_checkitem` | ` ` | Add item to checklist | | `list_checklists` | `` | Show all checklists on card | | `complete_checkitem` | ` ` | Mark item complete | | `uncomplete_checkitem` | ` ` | Mark item incomplete | #### Example Workflows **Managing a Kanban Board:** ```bash # List all boards to find the one you want python3 trello_api.py list_boards # Get lists from your board python3 trello_api.py list_lists BOARD_ID # Create a new card in "To Do" python3 trello_api.py create_card LIST_ID "New Feature" "Description here" # Move card to "In Progress" python3 trello_api.py move_card CARD_ID IN_PROGRESS_LIST_ID # Move to "Done" when complete python3 trello_api.py move_card CARD_ID DONE_LIST_ID ``` **Creating a Recipe Card with Shopping List:** ```bash # Create the recipe card python3 trello_api.py create_card LIST_ID "Pasta Carbonara" "Classic Italian pasta dish" # Add a shopping list checklist python3 trello_api.py create_checklist CARD_ID "Shopping List" # Add ingredients python3 trello_api.py add_checkitem CHECKLIST_ID "Spaghetti (400g)" python3 trello_api.py add_checkitem CHECKLIST_ID "Eggs (4)" python3 trello_api.py add_checkitem CHECKLIST_ID "Pecorino Romano (100g)" python3 trello_api.py add_checkitem CHECKLIST_ID "Guanciale (150g)" ``` ## Creating Your Own Skills Want to create a skill for a different service? See our [Creating Skills Guide](./docs/creating-skills.md). ### Skill File Structure Every skill needs at minimum: 1. **SKILL.md** - The skill definition file with frontmatter: ```markdown --- name: skill-name description: Brief description of what the skill does and when to use it. --- # Skill Name Instructions for OpenCode on how to use this skill... ``` 2. **Scripts** - Executable files that perform operations 3. **.env.example** - Template for required environment variables ### Best Practices - Keep SKILL.md concise - OpenCode reads this for context - Use clear command names that describe the action - Always include a `.env.example` (never commit actual credentials!) - Output minimal, structured data that's easy for AI to parse - Include example workflows in your documentation ## Security Notes - **Never commit `.env` files** - They contain sensitive API credentials - Always use `.env.example` files as templates - Add `.env` to your `.gitignore` - Rotate API keys if you accidentally expose them ## Requirements - Python 3.8+ (for Python-based skills) - OpenCode CLI installed - API credentials for the services you want to use ### Python Dependencies Install skill dependencies: ```bash pip install requests python-dotenv ``` Or for a specific skill: ```bash cd skills/trello-manager/scripts pip install -r requirements.txt ``` ## Contributing Contributions are welcome! If you've created a useful skill, consider submitting a pull request. 1. Fork the repository 2. Create your skill in the `skills/` directory 3. Include comprehensive documentation 4. Submit a pull request ## License MIT License - see [LICENSE](./LICENSE) for details. ## Links - [OpenCode Documentation](https://opencode.ai/docs) - [Trello API Documentation](https://developer.atlassian.com/cloud/trello/) - [relearn.ing Project Page](https://relearn.ing/projects/opencode-skills/) --- Built with cognitive architecture principles from [relearn.ing](https://relearn.ing)

trello-manager

Installation

SKILL.md