본문으로 건너뛰기
cccskills
무료GitHub에 공개

add-connector

Build or extend a PipesHub connector, an integration that syncs content from an external service or database. The skill guides API research, design decisions, permission mapping, implementation, testing, and documentation of what was actually verified.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

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.

연동 도구SlackJira
설치 방법 보기

이럴 때 유용합니다

  • Build a connector for an external service
  • Add a new content type to an existing connector
  • Review how source permissions map to PipesHub
  • Document live and simulated test results

포함된 파일(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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Load, clean, summarize, and join tabular data from CSV, Excel, JSON, or database exports using pandas. Check missing values, data types, and row counts, then independently verify key figures before reporting numbers printed by the code.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Summarizing revenue by region
  • Cleaning missing values and duplicate rows
  • Joining files by customer ID
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

Turn data into charts suited to comparisons, trends, distributions, relationships, or shares. Add clear titles, units, and accessible colors, then export a static PNG or interactive HTML with hover details and zoom controls.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Charting monthly revenue trends
  • Comparing totals across regions or categories
  • Examining order-size distributions
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

docx

무료

Create Word reports, memos, letters, and proposals with headings, tables, lists, and a table of contents. Also supports targeted edits to existing .docx files and reading or summarizing their text and tables.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Create a Word report or proposal
  • Edit selected passages in an existing document
  • Read and summarize document text and tables
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

Choose suitable libraries for converting spreadsheet data and image files, or extracting text and tables from documents. Covers supported format pairs and identifies conversions unavailable in the described environment before work begins.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Convert tabular data between CSV, Excel, and JSON
  • Change image formats or resize images
  • Extract text from Word documents
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

Unpack Word and PowerPoint files to inspect and edit their internal XML, the markup that stores document content. Repack targeted changes with XML syntax checks while preserving the original archive entry order.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Make a small edit inside a Word or PowerPoint file
  • Investigate errors in generated document XML
  • Inspect internal document parts and image references
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

pdf

무료

Create PDF reports, invoices, and letters, extract text or tables from existing PDFs, and fill interactive form fields. The skill also guides table layout, text wrapping, and page breaks so generated documents fit their pages.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Create a PDF report or invoice
  • Extract text and tables from an existing PDF
  • Fill fields in a PDF form
pipeshub-ai/pipeshub-ai3.8천2026년 10월 22일 업데이트

pipeshub-ai의 스킬 모두 보기

이 스킬의 문제 신고