The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
feat: Add ai-skills federated content and data (#48045)
Jeremias Menichellib90c84dce7c4
diff --git a/apps/docs/app/guides/getting-started/ai-skills/AiSkills.utils.ts b/apps/docs/app/guides/getting-started/ai-skills/AiSkills.utils.tsindex b6b68853082..b63abea02f3 100644--- a/apps/docs/app/guides/getting-started/ai-skills/AiSkills.utils.ts+++ b/apps/docs/app/guides/getting-started/ai-skills/AiSkills.utils.ts@@ -1,21 +1,8 @@-import matter from 'gray-matter'+import { readFile } from 'node:fs/promises'+import { join } from 'node:path'+import { GENERATED_DIRECTORY } from '~/lib/docs'import { cache } from 'react'-import { OCTOKIT_RETRY_OPTIONS, getGitHubFileContents, octokit } from '~/lib/octokit'--const SKILLS_REPO = {- org: 'supabase',- repo: 'agent-skills',- branch: 'main',- path: 'skills',-}--interface SkillMetadata {- name?: string- title?: string- description?: string-}-interface SkillSummary {name: stringdescription: string@@ -23,40 +10,8 @@ interface SkillSummary {}async function getAiSkillsImpl(): Promise<SkillSummary[]> {- const { data: contents } = await octokit().request('GET /repos/{owner}/{repo}/contents/{path}', {- owner: SKILLS_REPO.org,- repo: SKILLS_REPO.repo,- path: SKILLS_REPO.path,- ref: SKILLS_REPO.branch,- request: OCTOKIT_RETRY_OPTIONS,- })-- if (!Array.isArray(contents)) {- throw new Error('Expected directory listing from GitHub agent skills repo')- }-- const skillDirs = contents.filter((item) => item.type === 'dir')-- const skills = await Promise.all(- skillDirs.map(async (item) => {- const skillPath = `${SKILLS_REPO.path}/${item.name}/SKILL.md`- const rawContent = await getGitHubFileContents({- org: SKILLS_REPO.org,- repo: SKILLS_REPO.repo,- branch: SKILLS_REPO.branch,- path: skillPath,- })- const { data } = matter(rawContent) as { data: SkillMetadata }-- return {- name: item.name,- description: data.description || '',- installCommand: `npx skills add supabase/agent-skills --skill ${item.name}`,- }- })- )-- return skills.sort((a, b) => a.name.localeCompare(b.name))+ const raw = await readFile(join(GENERATED_DIRECTORY, 'ai-skills.json'), 'utf-8')+ return JSON.parse(raw)}export const getAiSkills = cache(getAiSkillsImpl)diff --git a/apps/docs/app/guides/getting-started/ai-skills/AiSkillsIndex.tsx b/apps/docs/app/guides/getting-started/ai-skills/AiSkillsIndex.tsxindex 1f5311a563c..0d04fd700cc 100644--- a/apps/docs/app/guides/getting-started/ai-skills/AiSkillsIndex.tsx+++ b/apps/docs/app/guides/getting-started/ai-skills/AiSkillsIndex.tsx@@ -1,5 +1,7 @@+import { CodeBlock } from 'ui-patterns/CodeBlock'+import Heading from 'ui/src/components/CustomHTMLElements/Heading'+import { getAiSkills } from './AiSkills.utils'-import { CopyButton } from './CopyButton'export async function AiSkillsIndex() {let skills: Awaited<ReturnType<typeof getAiSkills>> = []@@ -17,44 +19,18 @@ export async function AiSkillsIndex() {</div>)}+return (- <div className="not-prose overflow-x-auto">- <table className="w-full text-sm border-collapse">- <thead>- <tr className="border-b border-default">- <th className="text-left py-2 pr-4 text-foreground-lighter font-medium">Skill</th>- <th className="text-left py-2 pr-4 text-foreground-lighter font-medium">Description</th>- <th className="text-left py-2 text-foreground-lighter font-medium">Install command</th>- </tr>- </thead>- <tbody>- {skills.map((skill) => (- <tr key={skill.name} className="border-b border-default">- <td className="py-3 pr-4 font-mono text-xs whitespace-nowrap">- <a- href={`https://github.com/supabase/agent-skills/tree/main/skills/${skill.name}`}- target="_blank"- rel="noopener noreferrer"- className="text-foreground hover:text-brand transition-colors"- >- {skill.name}- </a>- </td>- <td className="py-3 pr-4 text-foreground-lighter">{skill.description}</td>- <td className="w-px p-0">- <div className="h-full max-w-xs overflow-x-auto flex items-center py-3">- <div className="flex items-center gap-2 whitespace-nowrap">- <CopyButton text={skill.installCommand} />- <code className="font-mono text-xs text-foreground-lighter">- {skill.installCommand}- </code>- </div>- </div>- </td>- </tr>- ))}- </tbody>- </table>- </div>+ <>+ {skills.map((skill) => (+ <div key={skill.name}>+ <Heading tag="h3">{skill.name}</Heading>+ <p>{skill.description}</p>+ <CodeBlock language="bash" className="language-bash">+ {skill.installCommand}+ </CodeBlock>+ </div>+ ))}+ </>)}diff --git a/apps/docs/app/guides/getting-started/ai-skills/CopyButton.tsx b/apps/docs/app/guides/getting-started/ai-skills/CopyButton.tsxdeleted file mode 100644index 1f974067655..00000000000--- a/apps/docs/app/guides/getting-started/ai-skills/CopyButton.tsx+++ /dev/null@@ -1,29 +0,0 @@-'use client'--import { useState } from 'react'-import { Check, Copy } from 'lucide-react'-import { cn } from 'ui'--export function CopyButton({ text }: { text: string }) {- const [copied, setCopied] = useState(false)-- const handleCopy = async () => {- await navigator.clipboard.writeText(text)- setCopied(true)- setTimeout(() => setCopied(false), 2000)- }-- return (- <button- type="button"- onClick={handleCopy}- className={cn(- 'inline-flex items-center rounded-md border p-1.5 transition-colors',- 'border-default bg-surface-100 text-foreground-lighter hover:bg-surface-200 hover:text-foreground'- )}- title={copied ? 'Copied!' : 'Copy to clipboard'}- >- {copied ? <Check size={14} /> : <Copy size={14} />}- </button>- )-}diff --git a/apps/docs/internals/generate-guides-markdown.ts b/apps/docs/internals/generate-guides-markdown.tsindex 5e19d7fd2fb..e018300827d 100644--- a/apps/docs/internals/generate-guides-markdown.ts+++ b/apps/docs/internals/generate-guides-markdown.ts@@ -15,6 +15,7 @@ import { mcpConfigPanelMarkdown as McpConfigPanel } from 'ui-patterns/McpUrlBuilimport { addBaseUrlPrefix, getInternalLinkBaseUrl, withDocsBasePath } from './internal-links'import { AccordionItem } from './markdown-schema/Accordion'import { Admonition } from './markdown-schema/Admonition'+import { AiSkillsIndex } from './markdown-schema/AiSkillsIndex'import { AuthProviders } from './markdown-schema/AuthProviders'import { ComputeDiskLimitsTable } from './markdown-schema/ComputeDiskLimitsTable'import { ContentListings } from './markdown-schema/ContentListings'@@ -165,6 +166,7 @@ function applySchema(parent: Parent, schema: ComponentSchema): void {const SCHEMA: ComponentSchema = {AccordionItem,Admonition,+ AiSkillsIndex,IconCheck,IconX,Image,diff --git a/apps/docs/internals/markdown-schema/AiSkillsIndex.ts b/apps/docs/internals/markdown-schema/AiSkillsIndex.tsnew file mode 100644index 00000000000..efa3e6174f4--- /dev/null+++ b/apps/docs/internals/markdown-schema/AiSkillsIndex.ts@@ -0,0 +1,27 @@+import { readFileSync } from 'node:fs'+import path from 'node:path'++const SKILLS_PATH = path.join(process.cwd(), 'features/docs/generated/ai-skills.json')++interface SkillSummary {+ name: string+ description: string+ installCommand: string+}++export const AiSkillsIndex = (): string => {+ const skills: SkillSummary[] = JSON.parse(readFileSync(SKILLS_PATH, 'utf-8'))++ return skills+ .map(+ (skill) =>+ `### ${skill.name}++${skill.description}++\`\`\`sh+${skill.installCommand}+\`\`\``+ )+ .join('\n\n')+}diff --git a/apps/docs/scripts/federated-content/fetch-federated-content.ts b/apps/docs/scripts/federated-content/fetch-federated-content.tsindex 23f19a912c7..b105012765a 100644--- a/apps/docs/scripts/federated-content/fetch-federated-content.ts+++ b/apps/docs/scripts/federated-content/fetch-federated-content.ts@@ -8,7 +8,7 @@ import { GENERATED_DIRECTORY, GUIDES_DIRECTORY } from '~/lib/docs'import remarkMkDocsAdmonition from '~/lib/mdx/plugins/remarkAdmonition'import { removeTitle } from '~/lib/mdx/plugins/remarkRemoveTitle'import remarkPyMdownTabs from '~/lib/mdx/plugins/remarkTabs'-import { getGitHubFileContents } from '~/lib/octokit'+import { getGitHubFileContents, octokit, OCTOKIT_RETRY_OPTIONS } from '~/lib/octokit'import matter from 'gray-matter'import { fromMarkdown } from 'mdast-util-from-markdown'import { gfmFromMarkdown, gfmToMarkdown } from 'mdast-util-gfm'@@ -163,10 +163,61 @@ async function fetchSource(source: FederatedContentSource): Promise<void> {])}+const AI_SKILLS_REPO = {+ org: 'supabase',+ repo: 'agent-skills',+ branch: 'main',+ path: 'skills',+}++/**+ * Lists the skill directories in the agent-skills repo, fetches each+ * `SKILL.md`'s frontmatter, and writes the summary to+ * `features/docs/generated/ai-skills.json` for `AiSkills.utils.ts` to read.+ */+async function fetchAiSkills(): Promise<void> {+ const { data: contents } = await octokit().request('GET /repos/{owner}/{repo}/contents/{path}', {+ owner: AI_SKILLS_REPO.org,+ repo: AI_SKILLS_REPO.repo,+ path: AI_SKILLS_REPO.path,+ ref: AI_SKILLS_REPO.branch,+ request: OCTOKIT_RETRY_OPTIONS,+ })++ if (!Array.isArray(contents)) {+ throw new Error('Expected directory listing from GitHub agent skills repo')+ }++ const skillDirs = contents.filter((item) => item.type === 'dir')++ const skills = await Promise.all(+ skillDirs.map(async (item) => {+ const rawContent = await getGitHubFileContents({+ org: AI_SKILLS_REPO.org,+ repo: AI_SKILLS_REPO.repo,+ branch: AI_SKILLS_REPO.branch,+ path: `${AI_SKILLS_REPO.path}/${item.name}/SKILL.md`,+ })+ const { data } = matter(rawContent) as { data: { description?: string } }++ return {+ name: item.name,+ description: data.description || '',+ installCommand: `npx skills add supabase/agent-skills --skill ${item.name}`,+ }+ })+ )++ skills.sort((a, b) => a.name.localeCompare(b.name))++ await mkdir(GENERATED_DIRECTORY, { recursive: true })+ await writeFile(join(GENERATED_DIRECTORY, 'ai-skills.json'), JSON.stringify(skills, null, 2))+}+async function fetchFederatedContent() {const sources = await loadSources()- await Promise.all(sources.map(fetchSource))+ await Promise.all([...sources.map(fetchSource), fetchAiSkills()])const pageCount = sources.reduce((sum, source) => sum + source.pageMap.length, 0)console.log(