本文へ移動
cccskills
無料GitHub で公開

add-connector

Build a new PipesHub connector, or extend an existing one, end to end, following CONNECTOR.md. Use when asked to add, create, build or port a connector or integration for an external source (Jira, Drive, Slack, a database, a SaaS API), or to add sync of a new object type to an existing connector.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Add a PipesHub connector

Follow CONNECTOR.md and the documents it links in docs/connectors/. This skill is the order of work and the points where you must stop; the documents hold the detail. Where they disagree with the code, the code is right: say so, and fix the document in the same PR.

1. Understand before you design

  1. Read CONNECTOR.md, then docs/connectors/01-high-level-design.md and 02-low-level-design.md.
  2. Pick the reference connector of the same shape from the table in docs/connectors/05-step-by-step.md and read its connector class, client and behaviour tests.
  3. Read the vendor's API documentation for everything listed under "Find out yourself" in docs/connectors/04-intake-questions.md. Note the documentation page for each fact.

2. Ask, once, with recommendations

Send the human one message with the questions in 04-intake-questions.md that the documentation did not answer, and the decisions in docs/connectors/03-decisions.md that need them. For each, give your recommendation and what you found, so they can confirm. Always ask for a test account and credentials, and say what cannot be verified without one.

Do not write code until the human has answered. If they cannot provide a test account, carry on with unit tests against fakes, and say in the PR that the connector was not run against the real source.

3. Write the design into the PR description

Before code: the "Connector intake" section, each decision from 03-decisions.md with its reason, and the permission mapping per object type from docs/connectors/06-permissions.md. Show it to the human if any part of the permission mapping errs towards over-sharing or hides content the source shows.

4. Build in phases

Work through docs/connectors/05-step-by-step.md phase by phase. Run each phase's check and do not start the next phase until it passes. While writing any API call, apply docs/connectors/07-errors-and-logging.md. While writing any record or group, apply 06-permissions.md.

Stop and ask the human when:

  • the source's sharing cannot be expressed without over-sharing;
  • a needed API scope may not be grantable, or needs a paid tier;
  • the live API contradicts its documentation;
  • you would need to change shared code under backend/python/app/connectors/core/, backend/python/app/models/ or the graph providers.

5. Finish

  1. Run the greps in 07-errors-and-logging.md on the new connector and its client, and read every hit.
  2. Run the checks in docs/connectors/08-testing.md: the contract tests, the connector's tests, the whole unit suite, ruff on the changed files.
  3. Go through CONNECTOR_CHECKLIST.md item by item, and copy it, ticked, into the PR description. For each unticked item, say why.
  4. Report to the human what was verified against the real source, what only against fakes, and what is known not to work.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use this skill whenever the user asks you to load, clean, aggregate, join, or otherwise analyze tabular data (csv, xlsx, json, or a database export) — 'what's the total revenue by region', 'clean up this dataset', 'join these two files on customer id'. Establishes a verification discipline so reported numbers are always numbers the code actually printed, never numbers you inferred or estimated.

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

Use this skill whenever the user asks for a chart, graph, plot, or visualization of data — 'chart this by month', 'show me a breakdown by category', 'visualize the trend'. Covers picking the right chart type for the question being asked, labeling/readability rules, and which plotting library to reach for. Pair with data-analysis for the underlying data prep.

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

docx

無料

Use this skill whenever the user asks for a Word document, a .docx file, or a report/memo/letter/proposal delivered as one — creating a new document from scratch, editing an existing .docx, or reading/summarizing the contents of one. Covers page layout, headings, tables, numbered/bulleted lists, page breaks, and a table of contents. Does not cover converting a .docx to PDF or .doc to .docx (see file-conversion for what conversions ARE supported in this environment).

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

Use this skill when the user asks to convert a file from one format to another (e.g. csv to xlsx, xlsx to json, pdf text to csv) and you're not sure which library handles that specific pair, or whether it's supported in this environment at all. Dispatches to the right library per format pair and explicitly lists conversions that are NOT supported here so you don't attempt one that will silently fail or produce a wrong result.

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

Low-level support skill for hand-editing the raw XML inside a .docx or .pptx file (both formats are just ZIP archives of XML parts). Use this directly only when you need to unpack, inspect, or repack Open XML yourself — for example fixing a validation error in generated markup, or making one small targeted edit without regenerating a whole document from scratch. The docx and pptx skills already use this internally for their 'edit an existing file' workflow, so you rarely need to load this on its own.

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

pdf

無料

Use this skill whenever the user asks for a PDF — generating a new one from scratch (reports, invoices, letters), extracting text/tables from an existing PDF, or filling in an existing PDF form. Does not cover converting an existing Word/PowerPoint/Excel file to PDF (that requires LibreOffice, not available in this environment — see file-conversion).

日本語の概要は準備中です。原文の説明を表示しています。

pipeshub-ai/pipeshub-ai3,8372026年10月17日 更新

pipeshub-ai のスキルをすべて見る

このスキルの問題を報告する