Function listSkillsFromGitHub

packages/cli/src/utils/github.ts:194–238

(project: string)

// TODO(deprecate-skills-phase-2): Remove direct GitHub Skill Hub fallback when
// deprecated `ctx7 skills install/info` commands are deleted.
export async function listSkillsFromGitHub(project: string): Promise<GitHubSkillsResult> {
  try {
    const parts = project.split("/").filter(Boolean);
    if (parts.length < 2) return { status: "error", error: "Invalid project format" };
    const [owner, repo] = parts;

    const headers = getGitHubHeaders();
    const branchResult = await fetchDefaultBranch(owner, repo, headers);
    if ("error" in branchResult) {
      if (branchResult.status === 404) return { status: "repo_not_found" };
      return { status: "error", error: branchResult.error };
    }

    const treeData = await fetchRepoTree(owner, repo, branchResult.branch, headers);
    if ("error" in treeData) return { status: "error", error: treeData.error };

    const skillMdFiles = treeData.tree.filter(
      (item) => item.type === "blob" && item.path.toLowerCase().endsWith("skill.md")
    );

    const skills: (Skill & { project: string })[] = [];
    for (const item of skillMdFiles) {
      const rawUrl = `${GITHUB_RAW}/${owner}/${repo}/${branchResult.branch}/${item.path}`;
      const response = await fetch(rawUrl, { headers });
      if (!response.ok) continue;

      const content = await response.text();
      const meta = parseSkillFrontmatter(content);
      if (!meta) continue;

      const skillDir = item.path.split("/").slice(0, -1).join("/");
      skills.push({
        name: meta.name,
        description: meta.description,
        url: `https://github.com/${owner}/${repo}/tree/${branchResult.branch}/${skillDir}`,
        project,
      });
    }

    return { status: "ok", skills };
  } catch (err) {
    const message = err instanceof Error ? err.message : String(err);
    return { status: "error", error: message };
  }
}

export async function getSkillFromGitHub(
  project: string,