Career Spotlight Finder

Use when wanting to discover hidden strengths, industry buzzwords, and career narratives from past projects, articles, or code — for resumes, self-introducti...

Security Scan

This is an instruction-only skill whose requested tools and file I/O are consistent with its stated purpose (analyzing local projects and producing local career-copy), with only a small inconsistency about pandoc being 'required' vs. 'optional fallback'.

Purpose & Capability

The skill's name, description, and runtime instructions consistently describe analyzing local projects, documents, and URLs to produce a local report and copy; the requested capabilities (read, glob, grep, bash, write, WebFetch) fit that purpose. One mismatch: SKILL.md / registry metadata lists pandoc as an 'anyBins' requirement (effectively required), but README and the guides state pandoc is optional with a fallback to python-docx. That inconsistency could cause false expectations about availability of conversion tools.

Instruction Scope

The SKILL.md and included guides explicitly instruct the agent to read user-provided local paths, repo files, converted .docx content, saved analyses in ~/.career-spotlight/, and to fetch only user-supplied URLs. This scope matches the stated purpose, but it does involve broad local file reads (project trees, config files, and metadata such as git hashes and mtimes) and will write files under ~/.career-spotlight/. The guides include explicit skip lists (e.g., .env, node_modules, .git) and caution about treating fetched web content as untrusted, which mitigates some concerns.

Install Mechanism

This is instruction-only with no install spec and no code files to execute from a downloaded archive. That is the lowest-risk install model.

Credentials

The skill declares no required environment variables or credentials. It optionally lists pandoc as an external binary. There are no requests for unrelated cloud credentials or sensitive tokens.

Persistence & Privilege

The skill does write and maintain a local workspace (~/.career-spotlight/) and archives prior reports, which is consistent with its function. It is not force-enabled (always: false) and does not request elevated or cross-skill configuration changes.

Assessment

What to consider before installing/running: 1) This skill will scan and read the project folders and documents you point it at and will create and write files under ~/.career-spotlight/ (analyses, report.md, copies/, history/). Do not point it at folders containing secrets, private keys, or sensitive data you don't want processed. 2) The registry metadata lists pandoc as a required binary but the README says pandoc is optional (fallback to python-docx). Install pandoc if you want robust .docx → markdown conversion, or ensure python-docx is available if you rely on the fallback. 3) The skill may fetch only the URLs you provide (WebFetch); avoid providing URLs that return private content you don't want downloaded. 4) Review the generated files after a run before sharing them externally. 5) If you are especially cautious, run the skill in a limited environment (container or VM) and grant it access only to the specific directories you want analyzed. 6) The skill claims "Everything stays local" and the instructions support that, but since this is instruction-only content from an external source, review the version on the linked repository (https://github.com/RealZST/career-spotlight-finder) if you need higher assurance that no external upload behavior has been added in later changes.

Discover hidden strengths and career narratives from your past projects.

Pipeline

Init → Analyze → Position → Synthesize → Write Copy → Review

Quick Reference

Step	Guide	Template
Init + Analyze	guides/input-collection-guide.md, guides/project-analysis-guide.md	templates/project-analysis.md
Position	guides/domain-positioning-guide.md	—
Synthesize	guides/narrative-synthesis-guide.md	templates/aggregated-report.md
Write Copy	guides/copywriting-guide.md	templates/copywriting-variants.md

Output

~/.career-spotlight/
├── analyses/    # per-project analyses
├── report.md    # aggregated career brand report
├── copies/      # resume-bullets, elevator-pitch, linkedin-summary, casual-intro
└── history/     # archived reports and prior copy

---

Step 0 — Init

Read guides/input-collection-guide.md Section 1 and follow its procedure to set up ~/.career-spotlight/.

Step 1 — Analyze

Read guides/input-collection-guide.md Sections 2-8 for the full procedure. Summary:

1. Collect sources from the user (local paths, URLs, or .docx files).
2. Validate and expand sources (auto-detect document collections in directories).
3. Ask the user to set project priorities (highlight or supporting).
4. Check existing analyses for staleness (via git hash, file mtime, or URL age).
5. Run new analyses per guides/project-analysis-guide.md, write to ~/.career-spotlight/analyses/.

Step 2 — Position

1. Read guides/domain-positioning-guide.md and follow Sections 2-4.
2. Recommend one expert framing with a distinctiveness thesis. Keep alternatives as wrappers.
3. Ask the user to confirm the framing before proceeding.

Step 3 — Synthesize

1. Read all analyses from ~/.career-spotlight/analyses/.
2. Read guides/narrative-synthesis-guide.md and follow its methodology.
3. Archive any existing report.md to ~/.career-spotlight/history/report-YYYY-MM-DDTHH-MM-SS.md.
4. Write the new report to ~/.career-spotlight/report.md using templates/aggregated-report.md.

Step 4 — Write Copy

1. Read ~/.career-spotlight/report.md.
2. Read guides/copywriting-guide.md and follow its methodology.
3. Archive any existing files in ~/.career-spotlight/copies/ to history/ with timestamp suffix.
4. Write four files to ~/.career-spotlight/copies/ using templates/copywriting-variants.md:
   • resume-bullets.md
   • elevator-pitch.md
   • linkedin-summary.md
   • casual-intro.md

Step 5 — Review

Present a summary: positioning statement, theme line count, top 3 hidden capabilities.

Then offer:

1. Add more projects → Step 1
2. Change domain direction → Step 2
3. Adjust narrative emphasis → Step 3
4. Regenerate copy variants → Step 4
5. Accept and finish — remind the user their files are at ~/.career-spotlight/