How to Audit Your Portfolio (And Why You're Doing It Wrong)
Learn how to audit your portfolio against live market data, not your own judgment. Free open-source Claude Code skill included, with real rewrites and a 30-day plan.
Most people who want to know how to audit their portfolio ask the wrong question. They audit the design. The layout. The project descriptions. They ask whether it looks professional. Whether it's complete. Whether the case studies are long enough.
None of that is the problem.
The problem is positioning. And positioning is the one thing you cannot see clearly from inside your own work.
Sun Tzu's most cited line is about knowing your enemy. But the full passage is almost always cut short. "If you know the enemy and know yourself, you need not fear the result of a hundred battles. If you know yourself but not the enemy, for every victory gained you will also suffer a defeat. If you know neither the enemy nor yourself, you will succumb in every battle."
The insight is not about aggression. It is about information asymmetry. The strategist who wins consistently is not the most talented. It is the one with the most accurate picture of the field. And that picture has two halves: what the opponent is looking for, and what you actually look like to them.
Most portfolio audits address neither half. They evaluate you in isolation, against an internal standard you set yourself, without reference to the actual market you are trying to enter. The result is feedback that feels useful but changes nothing.
How to Audit Your Portfolio (And Why Your Own Judgment Will Fail You)
The central problem with self-auditing is structural.
You wrote your portfolio to communicate what you have done. Which means you wrote it for someone who already understands your domain. The language, the framing, the choice of what to emphasize: all of it made sense to you because you had the context.
The hiring manager reading it cold does not have that context. They are pattern-matching against a mental model of what the role needs, formed by dozens of other candidates they have seen recently. If your language does not match that pattern in the first five seconds, it gets filed under "not relevant" before you have had a chance to prove otherwise.
This is not a problem you can solve by reading your own portfolio more carefully. You will always fill in the gaps from memory. The information gap is real, but it is invisible to the person standing in it.
What a portfolio audit is actually measuring
A genuine audit of your portfolio is not a design review. It is a translation audit.
The question it is answering: does the language on this page translate what you have done into terms that map to what this market is currently hiring for?
That question has two inputs. What you have actually done: your portfolio, your experience, your projects. And what the market is currently looking for: live job postings, current hiring patterns, the language employers are using right now.
Without both inputs, you are not auditing. You are editing against a benchmark you invented.
How to Audit Your Portfolio With Live Market Research
This is where most DIY audits collapse.
You can review your own copy until midnight, but if you are not cross-referencing it against current job postings, you are optimizing in a vacuum. Job markets shift. The language of hiring shifts with them. An audit done six months ago is already partially stale.
What live market research does in a portfolio audit:
- Pulls actual job descriptions for your target role from current postings
- Extracts the language, skills, and framing those postings use consistently
- Maps that language against your current portfolio copy
- Surfaces the specific gaps: words you are not using, angles you are missing, emphasis that is wrong for the current market
This is Sun Tzu's second half of the equation. You can know yourself completely: every project, every skill, every outcome. And still lose if you do not know what the market is actually looking for right now.
The four phases of a thorough portfolio audit
Phase 1: Role and background interview. Before anything is audited, the auditor needs to understand who you are and where you want to go. Role clarity, experience depth, target companies, and the narrative you are currently leading with. This is the baseline. Without it, the audit is guessing.
Phase 2: Live industry research. Current job postings in the target role are analyzed. What are hiring managers actually asking for? What language appears consistently? What do the best-positioned candidates in this space emphasize? The research is live. Not advice from a generic career coach working off last year's mental model.
Phase 3: Portfolio and LinkedIn audit. Every section is reviewed against the research. Headline, About, Experience, Projects, Skills. Not "is this good?" but "does this translate?" Specific, sentence-level rewrites are produced for every section that is not landing.
Phase 4: 30-day action plan. The audit closes with a prioritized sequence of changes ranked by impact. Not a list of everything that could be improved. A specific order of operations for the next 30 days, so you know exactly where to start.
Re-audit mode: tracking whether you actually moved
Most audits are one-shot. You get the feedback, you implement some of it, and you have no way to know whether the changes landed.
Re-audit mode solves this. Run the audit again after implementing changes, and it compares your current state against the previous report. It shows you exactly what moved, what did not, and what still needs work. A portfolio is not a one-time artifact. The audit process should match that.
The Free Tool That Runs This Process for You
I built a Claude Code skill that executes every phase of this audit automatically.
Download the Portfolio Audit Skill on GitHub
Install it into your Claude Code setup, run /portfolio-audit, and the skill walks you through the full process: the interview, the live market research, the audit of every portfolio and LinkedIn section, the specific rewrites, and the 30-day action plan. It also supports re-audit mode.
The skill is open-source. The full instruction set is readable. You can see exactly what it does and why, and fork it to fit your specific situation.
The audit is only as useful as what you do with the output. The skill gives you the diagnosis. Closing the gap is still on you. But at least the diagnosis is accurate, grounded in live data, and free of the blind spots that make self-audits useless.
Sun Tzu's point was never that winning required perfection. It required clarity. Know what the market is looking for. Know what you currently look like to the market. The distance between those two things is the only gap that actually matters.
Most portfolios are not failing because the work is bad. They are failing because no one ever looked at them with both halves of the picture in hand.
I build open tools like this and write about what I learn building them. Follow along on LinkedIn or X, or explore more at atifmanzoor.cloud.