skills.rest
withcoral
withcoralOFFICIAL
Explore all skills by this author →
WebsiteGitHub

coral-create-source-spec

Creates Coral source specification YAML files for APIs or datasets with validation via lint and SQL shape inspection.

4|3|Updated Apr 6, 2026
Search Tags:#linting#oauth#data modeling#http api#coral#sql integration#source spec
One-click install
npx skills add https://github.com/withcoral/skills --skill coral-create-source-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coral-create-source-spec
Source: https://github.com/withcoral/skills/tree/main/coral-create-source-spec
Command: npx skills add https://github.com/withcoral/skills --skill coral-create-source-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you turn an external HTTP API or local dataset into a valid, lintable, and queryable Coral source specification so agents can query real data through Coral.

Core Features & Use Cases

  • Generate complete source manifests: author metadata, backend settings, auth, variables/secrets, and typed tables/columns.
  • Add practical validation loops: lint, add, test, and then verify table/column/filter/function shapes via Coral SQL.
  • Model provider-native capabilities: define table functions (including search-style functions) and correct pagination, filters, and response extraction.

Quick Start

Ask the assistant to create a Coral source spec YAML for your provider by outlining one small endpoint, required auth/inputs, and a few typed columns, then validate it with coral source lint and coral sql queries.

Frequently Asked Questions about coral-create-source-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a queryable source spec for a custom HTTP API?▼

You create a queryable source spec by authoring a Coral source specification YAML file that defines endpoints, auth, typed tables, and columns. This manifest makes external API data queryable through Coral SQL.

What is the best way to model OAuth credentials in a source spec?▼

Modeling OAuth credentials in a source spec requires defining appropriate auth methods and inputs within the Coral source specification YAML. This ensures agents authenticate securely when querying HTTP APIs.

How do I validate a source spec manifest before adding it to a Coral repo?▼

Validate a source spec manifest by running coral source lint, add, and test commands. You then verify table, column, and filter shapes via coral sql queries to ensure schema validity.

Can I define table functions and pagination for local datasets in Coral?▼

Yes, Coral source specs support defining table functions and pagination for local datasets. You configure these provider-native capabilities, alongside filters and response extraction, directly within the YAML manifest.

Why does my coral source lint command fail on my HTTP API manifest?▼

Coral source lint fails on HTTP API manifests that are not schema-valid. You must repair the YAML by correcting missing typed columns, inaccurate auth modeling, or incomplete pagination definitions to pass validation.

Related Skills

Explore More Software Engineering Skills→
H2OSLabsH2OSLabs
1

schema-to-openapi

Converts Synnovator data schemas into OpenAPI 3.0 YAML or JSON specifications.

Official
Intermediate
withcoralwithcoral
4

coral-review-source-spec

Review Coral source manifests for quality and consistency standards.

Official
Intermediate
dlt-hubdlt-hub
53

view-data

Query and explore dlt pipeline data using Python and ibis expressions.

Official
Intermediate
JunjieTang-D1JunjieTang-D1
13

morning-briefing

Aggregate papers, blogs, stocks, and headlines into a Kindle PDF briefing.

Community
Advanced