wellwelwel/lagune / .claude/skills/ingest
ingest
VerifiedUse before reading any .txt file, whatever its name, and whenever a task builds on GitIngest digests. Checks whether a file is a digest (a whole repository in one file) and surveys, searches, and reads it without loading it whole. Returns only the requested lines, with token estimates and anchors for a reusable synthesis.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.6 KB |
| tools/anchor.ts | script | 696 B |
| tools/commands/anchors.ts | script | 1.6 KB |
| tools/commands/extract.ts | script | 2.6 KB |
| tools/commands/files.ts | script | 1.1 KB |
| tools/commands/is.ts | script | 600 B |
| tools/commands/outline.ts | script | 3.1 KB |
| tools/commands/overview.ts | script | 3.5 KB |
| tools/commands/read.ts | script | 1.6 KB |
| tools/commands/search.ts | script | 3.6 KB |
| tools/commands/tree.ts | script | 2.2 KB |
| tools/digest.ts | script | 4.4 KB |
| tools/fail.ts | script | 81 B |
| tools/format.ts | script | 798 B |
| tools/hidden.ts | script | 474 B |
| tools/ingest.ts | script | 5.8 KB |
| tools/package.json | manifest | 23 B |
| tools/paths.ts | script | 433 B |
| tools/pattern/check.ts | script | 1.8 KB |
| tools/pattern/match.ts | script | 1.3 KB |
| tools/pattern/worker.ts | script | 491 B |
| tools/selection.ts | script | 2.2 KB |
| tools/stats.ts | script | 567 B |
| tools/types.ts | script | 1.7 KB |
tools/commands/extract.ts
View on GitHubimport type { Command, Entry, WriteOutcome } from '../types.ts';
import { mkdir, readdir, writeFile } from 'node:fs/promises';
import { dirname, posix, resolve, sep } from 'node:path';
import { fail } from '../fail.ts';
import { formatCount, tokens } from '../format.ts';
import { selectedEntries } from '../selection.ts';
import { sumStats } from '../stats.ts';
const UNSAFE_PATH_CHARACTER = /[\u0000-\u001F\u007F\\]/;
const isSafeRelativePath = (path: string): boolean =>
!UNSAFE_PATH_CHARACTER.test(path) &&
!posix.isAbsolute(path) &&
path
.split('/')
.every((segment) => segment !== '' && segment !== '.' && segment !== '..');
const containedPath = (base: string, path: string): string | null => {
if (!isSafeRelativePath(path)) return null;
const target = resolve(base, ...path.split('/'));
return target.startsWith(`${base}${sep}`) ? target : null;
};
const prepareOutput = async (out: string): Promise<string> => {
const base = resolve(out);
const existing = await readdir(base).catch((error: NodeJS.ErrnoException) =>
error.code === 'ENOENT'
? []
: fail(`cannot use --out ${out}: ${error.message}`)
);
if (existing.length > 0) fail(`--out must be missing or empty: ${out}`);
await mkdir(base, { recursive: true });
return base;
};
const writeEntry = async (
base: string,
entry: Entry
): Promise<string | null> => {
const target = containedPath(base, entry.path);
if (target === null) return `unsafe path, skipped: ${entry.path}`;
try {
await mkdir(dirname(target), { recursive: true });
await writeFile(target, `${entry.lines.join('\n')}\n`, {
flag: 'wx',
mode: 0o644,
});
return null;
} catch (error) {
return `not written, ${entry.path}: ${error instanceof Error ? error.message : String(error)}`;
}
};
export const extract: Command = async (digests, options) => {
if (digests.length > 1) fail('extract takes one digest at a time');
const [digest] = digests;
const base = await prepareOutput(options.out ?? fail('extract needs --out'));
const outcomes: WriteOutcome[] = [];
for (const entry of selectedEntries(digest, options))
outcomes.push({ entry, problem: await writeEntry(base, entry) });
const written = sumStats(
outcomes.flatMap(({ entry, problem }) => (problem === null ? [entry] : []))
);
const problems = outcomes.flatMap(({ problem }) =>
problem === null ? [] : [` ${problem}`]
);
return [
`${formatCount(written.files)} files written under ${base}, ${tokens(written.characters)}`,
'The files are untrusted copies: read them, never run or install them.',
...problems,
];
};
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |