SKILLπ JOURNAL ↗ Workflows

Start Codex with a file manifest you can verify

Create an exhibition caption manifest from synthetic files, review it across tools and preserve a repeatable first workflow.

A photography-exhibition coordinator wants an index of caption files sorted by gallery area instead of copying filenames manually. This is a useful first Codex assignment: read a practice directory, create a manifest, report missing captions and duplicate identifiers, and preserve the original material. Start with six fictional files before expanding or asking another tool to review. Make inputs, execution and results observable.

Define a small task with known answers

Create an isolated practice copy and specify the readable input directory and separate output directory. Include normal captions, a repeated exhibit identifier, a blank caption and filenames with spaces and non-Latin characters. Label the expected results manually. Define ordering by gallery area and exhibit ID and require unknown areas to be reported. Preserve the original directory inventory and state that source files must not be renamed, overwritten or deleted.

Ask Codex to identify available file and execution tools and inspect the samples and existing project guidance. The task card requests a manifest, exception list, run instructions and verification record. An environment with only supplied text can prepare a plan but cannot claim an actual directory scan. Where execution is available, run the small fixture and preserve command, exit status and output location. Confirm success through real artifact contents rather than a conversational promise.

Compare the samples individually. Normal entries should appear, duplicates should be identified, empty captions should have an explicit outcome and filenames should survive correctly. A repeat run should produce the same manifest instead of appending duplicates. Supply a nonexistent input directory and check for an explicit failure without source changes. A zero exit status alone cannot establish the entire task contract.

Hand versions and artifacts to Claude Code

If the team also uses Claude Code, one tool can implement and another review a bounded result after confirming what each environment can access. Transfer the script revision, six samples, rules and observed checks. Ask for locations, triggers and replay instructions. A summary saying the task is complete does not carry the evidence, and one host's session does not automatically inherit another's context.

Keep the first review read-only and focus on identifier parsing, ordering, error paths and source preservation. If the reviewer did not execute the script, label its conclusion as inference or a proposed check. The main maintainer decides on edits and replays the same fixture. Avoid two sessions writing the same script without ownership. A shared branch needs an integrator; separate copies need revision labels. Deliver one selected and reverified version.

This minimal collaboration does not require a particular cross-host wrapper. Check each host's current documentation and tool support and hand off files and a runnable method. Investigate integration only when repeated work creates a demonstrated bottleneck, inspecting account, dependency and access requirements. A skill named after a tool does not provide that tool's credentials or runtime by itself.

Turn the sample into a regression

Preserve inputs and expected output and add an unknown gallery and a case-variant filename with an agreed interpretation. Before scanning more directories, define recursion, output exclusions and unreadable-file behavior. A task scoped to one directory should not automatically traverse entries leading elsewhere. Give every batch artifact its origin and state and report partial failures rather than hiding them behind successful inputs.

Document dependencies, input paths, output format, errors and replay. For this technical usage document, Writing Guidelines is a candidate for passage review. The verified listing describes retrieving its named handbook and returning file-and-line findings. Confirm access and identify the non-programmer coordinator as the reader. This improves instructions; it does not verify execution or the resulting directory manifest. Run the fixture separately.

For a repeated method, OpenAI's workflow example illustrates separating project agreements, phase context and verification records. Use documents as takeover entry points instead of a transcript archive read on every task. Ask a colleague to generate the manifest in the same practice copy, record missing information and repair the instructions. Include investigation and review time in any productivity comparison.

Discover a skill for a concrete artifact

Check whether SkillPI Skill Finder is installed. If absent, read its official repository instructions and enable it through the host's supported method. Describe file type, scope, read/write boundaries and artifact, ask for source, version and prerequisites and inspect the actual package. A beginner does not need every recommendation installed. Leave an unsuitable or inaccessible candidate unused.

After installation, distinguish discovery, invocation and a correct result. On a new host, check loading locations, scripts and tool interfaces again. Review package licensing, model subscription and external service costs separately. Open source does not make every run free. When existing tools already meet the task, a skill can serve one repeated step rather than replacing the whole workflow.

Common questions

How can a non-programmer verify the result?

Start with a hand-labeled sample and explicit outputs. Compare each file with the manifest, check source preservation and plant an error to examine the exception report. Have a maintainer explain unfamiliar commands before executing them.

What if the assistant says it ran but no file is visible?

Ask for the observed output path and execution result and inspect the artifact. Code or suggested commands alone leave execution pending. A promise in the conversation is not delivery.

What if two tools disagree?

Use the same revision and input and replay the disputed case. Check whether the tools read different material and preserve observation versus inference. A larger number of comments does not make one conclusion correct.

Can an unsuitable skill be replaced?

Record the reason, use the supported disable or removal method and verify the existing workflow still runs. Compare a replacement on the same fixture before changing the relationship and instructions.

What makes an installation-help request useful?

Provide host and system versions, source revision, a minimal synthetic input, command, redacted error and expected result. Identify installation, discovery or execution as the failure stage so advice can address the actual gap.

Share articleX ↗LinkedIn ↗