Skip to content
Skills Library
Programming · Building & coding

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

Repository
ai-kit ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

new extractor for Xbuild ex-something from scratchfresh repoempty git repo
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

  1. Step 1: Detect state
  2. Step 2: Gather component info
  3. Step 3: Run cookiecutter
  4. Step 4: Clean up and configure
  5. Step 5: Initial commit
  6. Step 6: Hand off
  7. Key resources
Original SKILL.md headings · 71 lines, 323 words
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

RepositoryScoreLicence
This page · keboola/ai-kit100MIT
firecrawl/firecrawl-cursor-plugin100MIT
hibira-io/agent-plugin100MIT
remotivated/job-hunt-skills100MIT
WestonBDev/roloe100Apache-2.0
aeonfun/aeon100MIT
coupler-io/skills100MIT
theopenapps/openapps-mcp100MIT
motleyai/motley-skills100MIT

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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.