get-started
/get-started
Mandatory initialization workflow for new Keboola Python components — use this skill before writing any code. Contains the exact cookiecutter command, Keboola-specific post-template cleanup steps, KBC_DATADIR directory structure, data/config.json format, and first commit format that are easy to get wrong without this reference. Invoke whenever the user is starting from a fresh or empty repository, has never built a Keboola component before, wants to run the cookiecutter template, or says things like "new extractor for X", "build ex-something from scratch", "fresh repo", "empty git repo", "bran
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Mandatory initialization workflow for new Keboola Python components — use this skill before writing any code. Contains the exact cookiecutter command, Keboola-specific post-template cleanup steps, KBC_DATADIR directory structure, data/config.json format, and first commit format that are easy to get wrong without this reference. Invoke whenever the user is starting from a fresh or empty repository, has never built a Keboola component before, wants to run the cookiecutter template, or says things like "new extractor for X", "build ex-something from scratch", "fresh repo", "empty git repo", "bran
Triggers from the description
Original author description
Mandatory initialization workflow for new Keboola Python components — use this skill before writing any code. Contains the exact cookiecutter command, Keboola-specific post-template cleanup steps, KBC_DATADIR directory structure, data/config.json format, and first commit format that are easy to get wrong without this reference. Invoke whenever the user is starting from a fresh or empty repository, has never built a Keboola component before, wants to run the cookiecutter template, or says things like "new extractor for X", "build ex-something from scratch", "fresh repo", "empty git repo", "bran
How it works
- Step 1: Detect state
- Step 2: Gather component info
- Step 3: Run cookiecutter
- Step 4: Clean up and configure
- Step 5: Initial commit
- Step 6: Hand off
- Key resources
SKILL.md preview
--- name: get-started description: > Mandatory initialization workflow for new Keboola Python components — use this skill before writing any code. Contains the exact cookiecutter command, Keboola-specific post-template cleanup steps, KBC_DATADIR directory structure, data/config.json format, and first commit format that are easy to get wrong without this reference. Invoke whenever the user is starting from a fresh or empty repository, has never built a Keboola component before, wants to run the cookiecutter template, or says things like "new extractor for X", "build ex-something from scratch", "fresh repo", "empty git repo", "brand new component", "never done this in keboola", "initialize a component", "scaffolding a new component", "just initialized the git repo", "nothing set up yet". Not for existing components that already have src/component.py. metadata: tools: "Bash, Read, Write, Edit, Glob, AskUserQuestion" model: sonnet color: green --- # Initialize New Keboola Component Before writing any code, check whether the component has already been initialized. ## Step 1: Detect state Check for signs of an existing cookiecutter setup: ```bash ls src/component.py component_config/ pyproject.toml 2>/dev/null ``` - If all present → skip initialization, hand off to `@develop-component` immediately - If missing or empty repo → proceed with initialization below ## Step 2: Gather component info You may already know the component details from the conversation. If not, ask: - **Component name** — kebab-case, no type suffix (e.g. `ex-salesforce`, not `salesforce-extractor`) - **Component ID** — `vendor.component-name` format (e.g. `keboola.ex-salesforce`) - **Type** — `extractor`, `writer`, or `application` - **Short description** — one sentence of what it does Naming rules: - Never include "extractor", "writer", or "application" in the name itself - Use prefix convention: `ex-` for extractors, `wr-` for writers ## Step 3: Run cookiecutter ```bash # Install if missing which cookiecutter || pip install --user cookiecutter cookiecutter gh:keboola/cookiecutter-python-component ``` Run interactively so the user can confirm the values. The template creates `src/`, `component_config/`, `tests/`, `.github/workflows/`, `Dockerfile`, `pyproject.toml`, and `data/` with example files. ## Step 4: Clean up and configure ```bash # Remove the generic example files that come with the template find data -type f -delete # Recreate the expected directory structure mkdir -p data/in/tables data/in/files data/out/tables data/out/files ``` Then create `data/config.json` with realistic example parameters based on what the component actually does — not a generic placeholder. Read `component_config/configSchema.json` if it already has content, and mirror the required fields with plausible example values. Use `#` prefix for sensitive fields (e.g. `"#api_key"`). ## Step 5: Initial commit ```bash git add -A git commit -m "feat: initialize component from cookiecutter template" ``` ## Step 6: Hand off Once initialized, pass to `@develop-component` to start the implementation. Share what you know about the component's purpose so it has context. --- ## Key resources - Cookiecutter template: `gh:keboola/cookiecutter-python-component` - Developer Portal: https://components.keboola.com/ - Component tutorial: https://developers.keboola.com/extend/component/tutorial/
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · keboola/ai-kit | 100 | MIT |
| firecrawl/firecrawl-cursor-plugin | 100 | MIT |
| hibira-io/agent-plugin | 100 | MIT |
| remotivated/job-hunt-skills | 100 | MIT |
| WestonBDev/roloe | 100 | Apache-2.0 |
| aeonfun/aeon | 100 | MIT |
| coupler-io/skills | 100 | MIT |
| theopenapps/openapps-mcp | 100 | MIT |
| motleyai/motley-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 8954c042235f (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90test-component
Expert agent for writing and maintaining tests for Keboola Python components. Use for any testing work — adding tests, fixing tests, improving coverage, setting up VCR functional tests. Covers datadir tests, unit tests, mock-based tests, and VCR recording with… - 100keboola-config
Use this skill when working with Keboola project configurations, understanding JSON config files, editing transformations, or analyzing Keboola project structure. Triggers on questions about Keboola configs, transformations, orchestrations, extractors, writers, or .keboola directories. - 100commit
Use when writing a commit message, and MUST invoke before creating any git commit. Provides commit message format and safety rules. - 100rseng-project-scaffolding
Covers starting research software projects from maintained templates and keeping them in sync: choosing a generator (Copier, cookiecutter), scaffolding a Python package, retrofitting template structure, pulling template upgrades into generated projects, and picking a pyproject… - 100code-scaffold-backport
Back-port an instance fix into the generator that produced it — cookiecutter, scaffold, `new-*` recipe. Use when fixing, reviewing, or auditing a generated file. - 100agentseek-lifecycle
Use when helping with AgentSeek-managed projects or AgentSeek-compatible templates: create projects, diagnose lifecycle issues, run doctor/dev/info/task commands, edit lifecycle specs, or maintain Cookiecutter template inputs. Prefer public AgentSeek CLI and template contracts.